Calendar Sync Errors
Fix issues with Google Calendar integration, from failed connections to missing or outdated events. HintMint uses your calendar to provide pre-call briefs and automatic meeting detection.
Common Symptoms
Calendar sync problems can affect how HintMint prepares for your meetings. Here are the most frequently reported issues:
- Calendar not connecting -- The Google Calendar integration shows an error or stays in a 'connecting' state indefinitely.
- Events not showing -- Your calendar is connected but upcoming meetings do not appear in HintMint's meeting list or pre-call briefs.
- Stale data -- Events that were rescheduled, cancelled, or recently added still show old information in HintMint.
Likely Causes
OAuth token expired
HintMint connects to Google Calendar using an OAuth token that Google issues when you first authorize the integration. These tokens can expire or be revoked if you change your Google password, remove HintMint from your Google account's connected apps, or if the token has simply aged past its validity window (typically 6 months of inactivity).
Insufficient permissions
During the initial authorization flow, HintMint requests read-only access to your Google Calendar events. If you skipped or unchecked the calendar permission during sign-in, HintMint will not be able to fetch your events. Some Google Workspace administrators also restrict which third-party apps can access calendar data.
Network or firewall issues
HintMint syncs calendar data over HTTPS. Corporate firewalls, VPN configurations, or DNS filtering tools may block the requests to Google's API endpoints, causing sync to fail silently or time out.
Re-authorize Google Calendar
If your token has expired or permissions were revoked, you will need to reconnect. Follow these steps to re-authorize:
Open HintMint Settings
Launch HintMint and click the gear icon in the top-right corner to open Settings. Navigate to the 'Integrations' tab.
Disconnect Google Calendar
Under the Google Calendar section, click 'Disconnect'. This clears the existing token and cached calendar data from HintMint.
Reconnect your account
Click 'Connect Google Calendar'. A browser window will open asking you to sign in with your Google account. Make sure to grant all requested permissions, especially 'View your calendars' and 'View events on all your calendars'.
Verify the connection
After authorization completes, return to HintMint. The Integrations tab should show a green 'Connected' badge next to Google Calendar, and your upcoming meetings should appear within a few seconds.
Check Permissions in Google
If reconnecting does not resolve the issue, verify that HintMint still has access on the Google side:
Visit your Google account permissions
Go to myaccount.google.com/permissions in your browser and sign in with the Google account you use with HintMint.
Find HintMint in the list
Scroll through 'Third-party apps with account access' and look for HintMint. Click on it to see which permissions it has.
Confirm calendar access is granted
You should see 'Google Calendar (read-only)' listed under the permissions. If it is missing, remove HintMint from the list entirely and then re-authorize from within the HintMint app using the steps in the previous section.
Verify Sync Status
HintMint syncs calendar data periodically in the background. You can check the current sync state and force a manual refresh:
Check the last sync timestamp
In Settings > Integrations > Google Calendar, you will see a 'Last synced' timestamp. If this is more than 15 minutes old and you have a stable internet connection, the sync may be stalled.
Force a manual sync
Click the 'Sync Now' button next to the timestamp. HintMint will immediately fetch the latest events from Google Calendar. A spinner will appear briefly, followed by an updated timestamp.
Check your network
If the manual sync fails, try opening calendar.google.com in your browser to confirm you can reach Google's servers. If you are on a corporate network, check whether a VPN or proxy is blocking outbound HTTPS traffic to googleapis.com.