# Connect Google Calendar

> Mirror WhatsApp appointment bookings into a Google Calendar.

_Source: https://hexafloww.com/docs/connect-accounts/connect-google-calendar_

---

Connecting Google Calendar mirrors WhatsApp appointment bookings onto a calendar of your choice. Every confirmed booking for a service you opt in becomes a calendar event.

> [!NOTE]
> This sync is **one-way**: a HexaFloww booking creates a Google Calendar event, but a Google Calendar event never blocks a booking slot.

> [!TIP]
> **Before you start**
> - You need the **Admin** or **Manager** role.
> - You need a Google account with a calendar you can write to.
> - WhatsApp appointment booking should already be set up — see [Appointment booking & reminders](https://hexafloww.com/docs/whatsapp/whatsapp-booking.md).

## Connect a calendar

1. **Open the Google Calendar connect page.** Sidebar → **Connect Accounts** → **Google Calendar**, or go to `/admin/connect-accounts/google-calendar`.
2. **Sign in with Google.** Click connect and approve calendar access.

   ![Google consent screen for Calendar access](https://hexafloww.com/docs/connect-accounts/gcal-consent.webp)
3. **Choose which calendar to use.** Pick one writable calendar. All synced bookings go onto this calendar.

   ![Calendar picker listing writable calendars](https://hexafloww.com/docs/connect-accounts/gcal-picker.webp)
4. **Turn on sync per booking service.** Open a booking service under `/admin/whatsapp/booking` and switch on **Google Calendar sync** in its settings. Turning it on back-fills every upcoming confirmed booking for that service.

## Common problems

- **Events stopped appearing** — the Google token was revoked, so the connection shows an error and sync pauses. Reconnect from this page; failed syncs retry automatically afterwards.
- **Only some bookings show up** — sync is only on for some services. Enable it on each booking service you want mirrored.
