> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voxworks.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Calendar Booking

> Create a Google Calendar event after checking free/busy availability.

## Overview

Tool name: `Google | Book Time in Calendar | Pro`

Use this tool to create a Google Calendar event after checking free/busy availability. See [Calendar Booking Overview](/tools/calendar/overview) for how availability and booking work across providers.

***

## Provider Settings

|    ID | Setting                | Type              | Required | Default       | What it does                                                                                                                            |
| ----: | ---------------------- | ----------------- | -------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `180` | attendee\_primary      | string            | Yes      | none          | Primary attendee email. Availability is checked against this calendar using Google freeBusy, and this attendee is added to the booking. |
| `181` | conflict\_calendar\_id | string            | No       | empty         | Optional extra Google calendar ID to check for conflicts. Use this when availability should also respect another calendar.              |
| `182` | duration\_minutes      | integer, minutes  | Yes      | none          | Appointment duration.                                                                                                                   |
| `183` | business\_days         | array             | Yes      | none          | Business days to offer, using ISO weekday numbers where Monday is `1` and Sunday is `7`. Example: `[1,2,3,4,5]`.                        |
| `184` | business\_hours        | time range object | Yes      | none          | Business hours window to offer. Example: `[0900,1730]`.                                                                                 |
| `185` | buffer\_minutes        | integer, minutes  | No       | `0`           | Minutes required before and after a candidate time for it to be considered available.                                                   |
| `186` | google\_meet           | boolean           | No       | false-like    | Whether to create a Google Meet link for the booking.                                                                                   |
| `187` | title                  | string            | No       | `Appointment` | Calendar event title.                                                                                                                   |
| `188` | description            | text              | No       | empty         | Description written to the Google Calendar event.                                                                                       |
| `189` | location               | string            | No       | empty         | Location written to the Google Calendar event.                                                                                          |
| `190` | invitee\_email         | string, email     | Yes      | none          | Email address of the invitee/customer being booked.                                                                                     |

***

## Common Settings

|  ID | Setting                               | Type    | Required | Default | What it does                                                                                            |
| --: | ------------------------------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------- |
| `0` | Number of Weeks                       | integer | No       | `4`     | Weeks to check availability. Tool definition range is `1-8`.                                            |
| `1` | SMS Message                           | text    | No       | empty   | Custom SMS confirmation message. Written to `{{sms.message}}`.                                          |
| `3` | Booking Purpose                       | text    | No       | empty   | Purpose of the appointment. Written to `{{calendar.purpose}}`.                                          |
| `5` | Check Timezone Before Booking         | boolean | No       | `false` | Whether the flow verifies the user's timezone before booking. Written to `{{timezone.check_timezone}}`. |
| `6` | Send SMS Confirmation                 | boolean | No       | `true`  | Whether to send an SMS confirmation after booking. Written to `{{calendar.sms_flag}}`.                  |
| `7` | Booking Window Start Offset (Minutes) | integer | No       | `15`    | Availability starts this many minutes after call start.                                                 |

***

## Availability Behavior

Availability is checked against the primary attendee's calendar using Google freeBusy, optionally also respecting `conflict_calendar_id`. Candidate slots are offered within the configured business days and business hours, honoring `buffer_minutes` before and after each candidate time.

If `google_meet` is enabled, the event creation request includes conference data for a Google Meet link.

***

## Global Variables Written or Maintained

| Variable                            | When set                            | Meaning                                                        |
| ----------------------------------- | ----------------------------------- | -------------------------------------------------------------- |
| `{{calendar.purpose}}`              | Tool entry                          | Booking purpose configured on the tool.                        |
| `{{sms.message}}`                   | Tool entry                          | Custom SMS confirmation message.                               |
| `{{timezone.check_timezone}}`       | Tool entry                          | Timezone verification flag.                                    |
| `{{calendar.sms_flag}}`             | Tool entry                          | SMS confirmation flag.                                         |
| `{{calendar.event_id}}`             | Availability load                   | Google calendar or integration identifier.                     |
| `{{calendar.availability_spoken}}`  | Availability check                  | Spoken availability response.                                  |
| `{{calendar.booking_time_raw}}`     | Slot validation and booking success | Exact selected slot in ISO date-time format.                   |
| `{{calendar.booking_time_spoken}}`  | Booking success                     | Spoken confirmation time.                                      |
| `{{calendar.booking_time_written}}` | Booking success                     | Written confirmation time.                                     |
| `{{calendar.booking_id}}`           | Booking success                     | Google Calendar event ID.                                      |
| `{{calendar.booking_link}}`         | Booking success                     | Google Calendar event link or Meet-related link when returned. |

***

## Cancellation Behavior

If the user cancels during the same call, the flow uses the Google Calendar cancellation path where supported. A successful cancellation clears the stored booking ID, booking link, and stored booking time values.

Output variable `result` is boolean `true` when the appointment was booked successfully.