Troubleshooting
Connection Issues
Fix login failures, sync problems, and EHR connection issues.
Login Problems
Email Link Not Arriving
If you don't receive the sign-in email:
- Check your spam/junk folder
- Verify you entered the correct email address
- Wait a few minutes — email delivery can sometimes be delayed
- Click Send another link to resend
- Try Sign in with password instead as an alternative
"Sign In Failed" Error
- Verify your email and password are correct
- Check your internet connection
- Try the email link method instead
Calendar Sync Issues
Calendar Not Showing Appointments
- Go to Settings → Integrations
- Check that Google Calendar shows "Connected"
- Click Sync Now to trigger a manual sync
- Verify that you have upcoming events on the connected Google Calendar account
Calendar Disconnected
If Google Calendar shows as disconnected:
- Click Connect to re-authorize
- Sign in with your Google account again
- Grant the required permissions
EHR Connection Issues
EHR Sync Failing
- Go to Settings → Integrations
- Check the EHR connection status
- Click Sync Now to retry
- If the connection shows errors, try disconnecting and reconnecting
EHR Connection Suspended (Dead Credentials)
If your EHR connection credentials (such as API keys, credentials, or OAuth tokens) expire or become invalid (e.g., due to password updates or security token rotations), Meelio will automatically suspend background synchronization to prevent lockout errors and notify your team immediately:
- Amber Reconnect Banner — A prominent amber status banner appears at the top of the application across the entire organization.
- Admins can click the Reconnect button directly on the banner to easily navigate to settings, open the credentials dialog, and input fresh credentials.
- Practitioner Members will see a message directing them to ask their practice administrator to reconnect the integration.
- Settings Page Status — Under Settings → Integrations, the affected EHR integration card will display Sync paused — reconnect needed. If credentials are close to expiring but still active, a soft amber warning will suggest reconnecting soon.
Patient Data Not Syncing
- Verify the EHR connection is active
- Check that practitioner mapping is configured correctly (Admin only)
- Trigger a manual sync
- Allow a few minutes for the sync to complete
EHR Authentication Expired
Some EHR integrations have authentication tokens that expire:
- Go to Settings → Integrations
- Disconnect the EHR provider
- Reconnect by clicking Connect and completing the authentication again
General Connection Problems
App Seems Slow or Unresponsive
- Check your internet connection
- Quit Meelio (Cmd+Q) and reopen
- Check if a Meelio update is available (click your avatar → Check for Updates)
Actions Fail with Network Errors
- Verify your internet connection is working
- Try switching between Wi-Fi and ethernet if available
- Restart Meelio
- If the issue persists, there may be a server-side issue — try again in a few minutes