Background Sync
FanDesk keeps your data synchronized with external services automatically.
How Sync Works
Sync Frequencies
| Service | Frequency | What Syncs |
|---|---|---|
| Gmail | 60 seconds | Inbox, Sent, Labels |
| Google Calendar | 5 minutes | Events, Calendars |
| Google Contacts | 15 minutes | All contacts |
| GitHub Issues | 10 minutes | Issues from linked repos |
| GitHub CI | 5 minutes | PR status |
Incremental Sync
FanDesk uses smart sync to be efficient:
Gmail
- Uses history ID tracking
- Only fetches changes since last sync
- Full sync only on first connect
Calendar
- Uses sync tokens
- Fetches only modified events
- Handles deletions properly
Token Refresh
OAuth tokens are refreshed automatically:
- Every 15 minutes
- Before they expire
- Seamless to user
Manual Refresh
Force a sync manually:
- Go to the relevant section (Mail, Calendar, etc.)
- Click the refresh icon
- Sync runs immediately
Sync Status
Check sync health:
- Go to Settings > Integrations
- See last sync time per service
- Status shows any errors
Troubleshooting
Data Not Updating
- Check integration status
- Try manual refresh
- May need to reconnect
Sync Errors
- Token expired: Reconnect integration
- Rate limited: Wait a few minutes
- Permission changed: Re-authorize
Next: Learn about real-time updates in Real-time Updates.
Need help? Contact us at hello@fandesk.live