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

# Calendly

> Let your agent book appointments using your Calendly event types

Calendly connects your scheduling account so the **Book with Calendly** tool can offer open times and create bookings during a conversation. A personal access token is the private code that lets Botcadence use that account.

## Prerequisites

* A Calendly account with at least one event type
* A **Personal Access Token** from Calendly (Integrations or developer settings in Calendly)
* 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 **Calendly** card.
  </Step>

  <Step title="Paste your token">
    On **Calendly Token**, enter **Personal Access Token**. Keep this secret.
  </Step>

  <Step title="Wait for validation">
    The wizard retrieves your Calendly profile. When it succeeds, you see **Calendly Connected!**
  </Step>
</Steps>

## Verify

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

<Check>
  Enable **Book with Calendly** on a test agent, start a conversation, and confirm the agent can list your event types or offer a booking link.
</Check>

## Use it

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

The agent uses your Calendly event types to help the customer schedule. Availability still follows what you configured in Calendly (hours, buffers, and cancellations).

## Limits

* A revoked or expired personal access token breaks booking until you edit the integration and paste a new token.
* The tool only works after you enable it and pick this connection. Connecting Calendly on **Integrations** is not enough by itself.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Token validation fails">
    Create a new personal access token in Calendly and paste it again. Do not add extra spaces.
  </Accordion>

  <Accordion title="The agent cannot book">
    Enable **Book with Calendly**, select this integration, and confirm event types exist and are public enough for the token’s account.
  </Accordion>

  <Accordion title="Wrong calendar or host">
    The token belongs to one Calendly user. Connect the account that owns the event types you want, or create a separate integration for another host.
  </Accordion>
</AccordionGroup>