Connect Google Calendar

Connect Google Calendar

FlowCaptain reads and writes to your Google Calendar via a service account. You need to share your calendar with this account so FlowCaptain can check availability and create/modify events.

Step-by-Step

1. Open Google Calendar in your browser
2. Find the calendar you want to connect in the left sidebar
3. Click the three dots next to the calendar name and select Settings and sharing
4. Scroll down to Share with specific people or groups
5. Click Add people and groups
6. Enter the FlowCaptain service account email (shown in your dashboard during onboarding)
7. Set the permission to Make changes to events
8. Click Send

Required Permission Level

FlowCaptain needs "Make changes to events" permission. This allows the API to:

• Read your calendar to check availability (FreeBusy)
• Create new events when appointments are booked
• Modify events when appointments are rescheduled
• Mark events as cancelled

"See all event details" is not sufficient — FlowCaptain needs write access to manage appointments.

Which Calendar to Share

Share the calendar where you want appointments to appear. This is usually your primary calendar, but you can use a dedicated "Appointments" calendar if you prefer to keep things separate.

Troubleshooting

• Calendar not showing availability: Double-check the permission level is "Make changes to events", not just "See all event details"
• Events not appearing: Make sure you shared the correct calendar (not a different one from the same Google account)
• Service account email: The email address is shown in your FlowCaptain dashboard on the calendar settings page