Fix a calendar connection problem
Fix a Google Calendar connection that won't connect, needs reconnecting or isn't showing busy time.
Purpose
Use this when a doctor's Google Calendar won't connect, shows it needs reconnecting, or isn't keeping busy time free in Keel. Work down the list in order and fix the first ✗ you find.
Checklist
- If you see: Calendar sync is not enabled yet. We will turn it on shortly.Calendar connection isn't available for your clinic yet
- If you see: No + Connect calendar under any doctor on CalendarFinance can't manage calendars. Ask the Owner or Front Desk.
- If you see: You can only connect your own calendar.A Doctor can connect only their own. Ask the Owner or Front Desk.
- If you see: Finish the Google sign-in in the popup, then click Reconnect…Finish signing in, then select Reconnect. Sign in to Google
- If you see: Calendar needs reconnect under the doctorPoint at the message to see what went wrong. Select Reconnect and sign in to Google again. Then select Sync now, reload the page, and check the doctor's events show as Busy · Google. The row can keep showing Calendar needs reconnect after this, so go by the busy time, not the label.
- If you see: Calendar sync failed — reconnect the calendar. or … need reconnecting. after Sync nowSelect Reconnect under each doctor who shows Calendar needs reconnect
- If you see: A Could not … Please try again. messageTry again. If it keeps happening, reload the page first.
- If you see: Calendar synced., but a busy event is missingReload the page. Then check the event is marked busy, is on the doctor's main calendar and is within the next 60 days. See imported busy time
- If you see: Busy time from the wrong Google account appearsWhile the row reads Connected, select Reconnect and sign in with the doctor's own account. Then select Sync now, reload, and check the Busy · Google blocks match the doctor's calendar. Don't use Disconnect for this: busy time already brought in from the wrong account stays and keeps blocking the doctor's times. Appointments Keel already added to the wrong account stay there too.
- If you see: A booking doesn't appear in the doctor's Google CalendarCheck the doctor's row doesn't show Calendar needs reconnect. Keel retries adding bookings once a day. Check a booking in Google
- Working: Calendar synced. and the doctor's events shown as Busy · GoogleThe connection is working
Checked against the Keel product source and in the live product on 2026-10-09. A connection showing Calendar needs reconnect, with Reconnect and Disconnect, was observed. Connecting, reconnecting, Sync now and the error messages were not exercised.