How to connect Google Calendar to BookFlow AI

Why this matters

BookFlow AI books meetings onto real calendars. Before your agent can offer time slots to a lead, it needs read and write access to the calendar where those meetings should land. Google Calendar is the fastest and most common integration.

Before you begin

You need:

• A Google account that owns the calendar where meetings should be created (not a shared inbox).
• Admin access to your BookFlow AI workspace (or the account that completed onboarding).
• Two minutes.

Step 1 — Open the calendar connection screen

Sign in to BookFlow AI and go to **Onboarding → Calendar sync** (if you have not finished onboarding yet) or **Integrations → Google Calendar** from the dashboard sidebar. Click the **Connect Google** button.

Step 2 — Approve the OAuth scopes

Google will open a consent screen. BookFlow requests exactly three scopes:

• **See and edit events on calendars you own** — needed to create booked meetings.
• **See free/busy information** — needed to know when you are already booked so we do not double-book you.
• **Basic profile info (name and email)** — needed to associate the calendar with the right account.

Click **Allow**. Google will redirect you back to BookFlow AI with a confirmation message.

Step 3 — Confirm the calendar is connected

On the Integrations page (or Step 2 of onboarding), you should see a green **Connected** badge next to Google Calendar. The primary calendar on that Google account is now the default target for booked meetings.

How it works during a live call

When a lead reaches the scheduling step of a conversation, your AI agent queries Google Calendar Free/Busy **at that exact moment** — no caching, no stale data. It offers two or three open slots from within your configured booking window, lets the lead pick one, then writes a new event to your calendar with the lead's details, a call summary, and a join link.

Changing or disconnecting the calendar

To connect a different Google account, first disconnect the current one from **Integrations → Google Calendar → Disconnect**, then connect the new one. You can also revoke BookFlow AI access directly from your Google Account permissions page.

Troubleshooting

**"The calendar connection failed"** — Make sure you approved all three scopes during the Google consent screen. Partial consent is not enough. Try connecting again.

**"Meetings are going to the wrong calendar"** — BookFlow writes to the **primary** calendar on the connected Google account. To write to a secondary calendar, contact support and we will help you configure it.

**"I see events on Google Calendar that I did not create"** — Those are test events from your agent's onboarding sandbox. You can delete them safely.

Need more help? Open the support widget in the bottom-right corner of any BookFlow AI page.