> ## 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.

# Calendly Booking

> Book an appointment through a Calendly event type.

## Overview

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

Use this tool to book an appointment through a Calendly event type. 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                                                                                                          |
| ----: | --------- | ----------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------- |
| `101` | Event URL | string, URL | Yes      | none    | Calendly event link, for example `https://calendly.com/username/30min`. Availability and booking use this event type. |

***

## 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

Calendly availability is loaded from the configured Event URL. The tool converts Calendly slots into the shared calendar format used by the booking flow.

***

## 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                   | Calendly event URL.                                 |
| `{{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                     | Calendly booking or event identifier when returned. |
| `{{calendar.booking_link}}`         | Booking success                     | Calendly link when returned.                        |

***

## Cancellation Behavior

If the user cancels during the same call, the flow uses the Calendly 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.