FanDesk

Background Sync

FanDesk keeps your data synchronized with external services automatically.

How Sync Works

Sync Frequencies

ServiceFrequencyWhat Syncs
Gmail60 secondsInbox, Sent, Labels
Google Calendar5 minutesEvents, Calendars
Google Contacts15 minutesAll contacts
GitHub Issues10 minutesIssues from linked repos
GitHub CI5 minutesPR 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:

  1. Go to the relevant section (Mail, Calendar, etc.)
  2. Click the refresh icon
  3. Sync runs immediately

Sync Status

Check sync health:

  1. Go to Settings > Integrations
  2. See last sync time per service
  3. Status shows any errors

Troubleshooting

Data Not Updating

  1. Check integration status
  2. Try manual refresh
  3. 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