Google Calendar scheduling integration guide
Check conflicts and add confirmed meetings. The intended connection would read free/busy across every Google calendar you actually attend, then write the confirmed meeting to one chosen destination calendar.
PROVIDER SETUP GUIDE. Documented workflow, not a live Google Calendar connection.Google Calendar at a glance
| Category | Calendars |
|---|---|
| Status | Provider setup guide |
| Job | Read free/busy across every google calendar you actually attend, then write the confirmed meeting to one chosen destination calendar |
| Data exchanged | Free/busy status for the booking window; event start, end, zone, and location; reschedule and cancellation state |
| Related capability | Calendar scheduling integration |
What the Google Calendar connection is designed to do
For calendars workflows, the important job is to read free/busy across every Google calendar you actually attend, then write the confirmed meeting to one chosen destination calendar. Check conflicts and add confirmed meetings. It sits beside the other calendars connections and supports the calendar scheduling integration requirements.
Google Calendar-specific integration decisions
Separate Google primary, secondary, shared, and personal conflict calendars from the single destination calendar that should receive confirmed events.
Check these against current Google Calendar documentation and your account edition; the verification standard explains how provider claims are reviewed.
Google Calendar provider review points
- Separate google primary
- Personal conflict calendars from the single destination calendar that should receive confirmed events
Scheduling data and actions in the workflow
For Google Calendar, these are the data groups the connection exchanges. Record the source, destination, and owner of each before granting access:
- Free/busy status for the booking window
- Event start, end, zone, and location
- Reschedule and cancellation state
Common Google Calendar scheduling use cases
- Keeping a work and a personal google calendar from colliding
- Letting a shared team calendar block time without receiving events
- Releasing a slot again the moment a google event is deleted
Google Calendar setup and verification checklist
- Grant consent with the Google account that should own production events, not a personal one.
- Tick each calendar that must block time, then separately choose the one destination calendar.
- Book a slot, then create a conflicting Google event and confirm the slot disappears.
- Check that a private event title never appears on the public booking page.
Availability, permissions, and limits
A calendar connection should expose availability, not private appointment content. Account permissions and administrator policy can also restrict what is available.
Retry and duplicate handling is covered in the API and webhook guide; ask about Google Calendar to confirm production status before building on it.
Map the Google Calendar workflow before connecting it.
Bring the trigger, required data, failure path, and desired guest outcome.
Discuss the connectionGoogle Calendar integration questions
Provider-specific answers for teams planning a Google Calendar scheduling connection.
Which Google calendars should block booking time?
Every calendar holding real commitments — primary, secondary, and any shared calendar you are genuinely expected to attend. Blocking time and receiving confirmed events are separate settings, so a calendar can do one without the other.
Will invitees see my private event titles?
No. A calendar connection should read free/busy status only. Verify this by booking as a signed-out guest and checking that a private appointment shows as unavailable time with no title attached.
Why did a Google Calendar connection stop working?
Password changes, revoked consent, new MFA enrolment, or a Workspace admin policy all invalidate the token. Assign an owner for reconnects rather than discovering it through a double booking.
Google Calendar data and lifecycle decisions
1. Choose the identity model
Google accounts carry several calendars: the primary, secondaries the user created, calendars shared by colleagues, and personal ones on the same account. Decide which of these are conflict sources and which single calendar receives confirmed Meetin.gs events. Most people want work primary plus one personal calendar blocking time, and the work primary as the destination.
2. Protect business ownership
Shared calendars are the ownership trap. If a team calendar blocks time for one host, every host who subscribes to it inherits those blocks. Ask each host to name their own conflict calendars rather than importing a shared list, and never write confirmed events to a calendar the host does not own.
3. Map the full lifecycle
Google marks all-day events as free by default and honours the busy/free flag per event. Decide whether all-day entries and tentative responses block a slot before anyone books. On reschedule, update the same Google event ID; on cancellation, delete or mark it cancelled so the guest's copy also disappears.
4. Keep traceable evidence
Store the Google event ID beside the Meetin.gs booking so a later change can be traced. Test a booking that lands during a daylight-saving transition and one against a recurring event with an exception; both are common sources of a missed conflict.