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

# Cal.com Booking

> Book an appointment through a Cal.com event.

## Overview

Tool name: `Cal.com | Book Time in Calendar | Pro`

Use this tool to book an appointment through a Cal.com event. 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                                                                                                                |
| ----: | ---------- | ----------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------- |
| `120` | event\_url | string, URL | Yes      | none    | Cal.com event URL, for example `https://cal.com/jared-buncombe-mcw6jg/15min`. 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

Cal.com availability is loaded from the configured event URL and converted 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                   | Cal.com event URL or event 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                     | Cal.com booking ID.                             |
| `{{calendar.booking_link}}`         | Booking success                     | Link returned by provider logic when available. |

***

## Cancellation Behavior

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