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 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 respectingconflict_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 variableresult is boolean true when the appointment was booked successfully.