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

# Connecting Cal.com

> Generate a Cal.com API key and connect it to Voxworks so your voice agents can book appointments into your Cal.com event types.

## Overview

Cal.com is a calendar integration. Connecting it links your Cal.com account to your Voxworks team so the [Book Calendar Appointment | Pro](/tools/calendar/calcom) tool can check availability and create bookings against a Cal.com event type during a call.

The connection uses an **API key** — you generate the key in Cal.com, paste it into Voxworks once, and Voxworks encrypts and stores it. There is no OAuth redirect.

Until Cal.com (or another calendar provider) is connected, the calendar booking tool does not appear in the script editor's tool picker at all — connecting is the prerequisite step before any event-URL booking can be configured.

<Note>
  Integrations are typically built out for specific clients, so the full functionality of Cal.com's interface might not be available. If your team needs additional features from this integration, contact the Voxworks team directly to discuss what can be added.
</Note>

***

## Generating your Cal.com API key

You create the key inside Cal.com, not in Voxworks:

1. Sign in to your Cal.com account.
2. Open **Settings**, then find **API keys** under the **Developer** section.
3. Create a new API key and copy it. Cal.com only shows the full key when it is created, so copy it before leaving the page.

Two tips while you are in Cal.com:

* **Set the key to never expire** (or diarise the expiry). If the key expires, bookings from calls stop working until you reconnect with a fresh key.
* **Note your event type link** — the public booking link for the event type you want the assistant to book, for example `https://cal.com/jane-smith/15min`. You will need this later when configuring the booking tool; it is not needed to connect.

***

## Connecting Cal.com to Voxworks

1. In the sidebar under **Admin**, open **Integrations**.
2. In the **Available Integrations** section, find the **Cal.com** card. It carries a **Calendar** badge and the description "Integrate with Cal.com for automated scheduling".
3. Click **Connect**. The **Connect Cal.com** dialog opens: "Enter your Cal.com API key to establish the connection."
4. Paste your key into the **API Key** field and click **Connect**.

| Field   | Required | Description                                                                                                                                                                                                                                |
| ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| API Key | Yes      | Your Cal.com API key. The field is masked as you type, and the key is encrypted before it is stored — the dialog notes "Your API key will be securely encrypted and stored." The **Connect** button stays disabled until a key is entered. |

On success you'll see an "Integration connected successfully" message, and the Cal.com card moves to the **Connected Integrations** section with a green **Connected** badge. The card's footer shows how many tools the connection makes available.

<Note>
  Voxworks stores the key immediately and does not test it against Cal.com at connect time. A mistyped or revoked key only surfaces later, as availability or booking failures on calls — so double-check the key you paste, and run a test call after setup.
</Note>

***

## What connecting unlocks

Once Cal.com shows as **Connected**:

* **Book Calendar Appointment | Pro** appears in the tool picker when you edit a script step. The picker hides integration-bound tools until their provider is connected.
* With Cal.com as the provider, the tool adds one required Cal.com-specific field alongside its shared settings: **event\_url** — the Cal.com event URL for the event type the assistant books into. It is a string, for example `https://cal.com/jane-smith/15min`, and accepts either a literal value or a variable (type `/` in the field to insert one).
* If your team has more than one calendar provider connected, a provider select appears in the tool's configuration panel so you can choose Cal.com explicitly.

<Warning>
  Connecting Cal.com can also surface an older tool named **Cal.com | Book Time in Calendar | Pro** in the picker. It is the superseded predecessor of Book Calendar Appointment | Pro (it takes the same `event_url` field) — use **Book Calendar Appointment | Pro** in all new scripts.
</Warning>

Successful bookings are written to `{{calendar.*}}` variables your flow can speak or send — for example `{{calendar.booking_time_spoken}}` (string, e.g. `10:30 AM on Tuesday the 22nd of July`) and `{{calendar.booking_link}}` (string, e.g. `https://cal.com/booking/abc123`). The full field-by-field and variable reference lives on the [Cal.com booking tool page](/tools/calendar/calcom), and the settings shared by every calendar provider (availability window, SMS confirmation, timezone check) are on the [calendar tools overview](/tools/calendar/overview).

***

## Managing or removing the connection

Click the gear icon on the connected Cal.com card to open **Integration Settings**:

* **Status** — a **Connected** badge plus an **API Key** badge showing the authentication type. If the connection has failed, an **Error** badge appears here and on the card, with the error message.
* **Connection Details** — when the connection was made and a masked view of the stored API key. The key is never displayed again after connecting.
* **Available Tools** — how many tools this connection enables.

To replace the key (for example after rotating it in Cal.com), disconnect and reconnect with the new key. If the card shows an **Error** badge, it offers a **Reconnect** button that reopens the connect dialog directly.

To remove the connection, click **Disconnect** in Integration Settings. The **Disconnect Cal.com?** dialog warns that disconnecting will stop active workflows using the integration, remove access to Cal.com features from your AI agents, and delete the stored authentication tokens. Any script step still configured with the Cal.com booking tool will fail to book until you reconnect. You can reconnect at any time by entering an API key again.

***

## Next Steps

* [Book Calendar Appointment — Cal.com](/tools/calendar/calcom) — the booking tool's Cal.com fields, behaviour, and the variables it writes.
* [Calendar tools overview](/tools/calendar/overview) — settings shared by every calendar provider, from availability windows to SMS confirmations.
* [Integrations overview](/integrations/overview) — how integration connections work across your team.
* [Creating a script](/scripts/creating-a-script) — build the script that puts the booking tool to work.