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

# Cal.com

> Check availability and book meetings through Cal.com

Cal.com connects your Cal.com account so the **Book with Cal.com** tool can check open times and create meetings during a conversation. The API key is the private access code Cal.com gives you for this connection.

## Prerequisites

* A Cal.com account
* An API key from the Cal.com developer or settings area
* Permission to add integrations on the project

## Connect

<Steps>
  <Step title="Open Add Integration">
    In the project sidebar, select **Integrations**, then **Add Integration**. Select **Connect** on the **Cal.com** card.
  </Step>

  <Step title="Paste your API key">
    On **Cal.com API Key**, enter **API Key**. Keep this secret.
  </Step>

  <Step title="Wait for validation">
    The wizard authenticates with Cal.com. When it succeeds, you see **Cal.com Connected!**
  </Step>
</Steps>

## Verify

On **Integrations**, the row shows **Connected**.

<Check>
  Enable **Book with Cal.com** on a test agent and confirm it can offer times that match your Cal.com event types.
</Check>

## Use it

Enable [Book with Cal.com](/docs/build/workflows/tools/calcom) on chat **AI Configuration** or a workflow **Tools** tab. Select this Cal.com connection.

## Limits

* Rotating the API key in Cal.com without updating **Integrations** stops booking.
* Availability, time zones, and event length come from Cal.com, not from Botcadence defaults.

## Troubleshooting

<AccordionGroup>
  <Accordion title="API key validation fails">
    Generate a new key in Cal.com and paste it again. Confirm you copied the full key.
  </Accordion>

  <Accordion title="The agent cannot schedule">
    Enable **Book with Cal.com** and select this integration. Confirm event types are published in Cal.com.
  </Accordion>
</AccordionGroup>