> ## Documentation Index
> Fetch the complete documentation index at: https://docs.retellai.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Connect Calendly
> Connect Calendly to Retell AI with a personal access token so agents can check availability, book appointments, and cancel scheduled events.
Connecting Calendly takes a personal access token. One connection gives you [agent functions](/integrations/calendly-functions): your agents check real availability, book appointments, and look up or cancel scheduled events.
This page covers the token Retell needs and the connection itself.
## When to use it
Connect Calendly when your scheduling already runs on it and you want callers booked without a human in the loop. It's the right choice when you want to:
* **Read live openings to the caller.** The agent checks the event type's availability and offers actual slots.
* **Book while the caller is on the line.** After the caller confirms a time and gives their name and email, the agent books it; the invitee gets Calendly's usual confirmation.
* **Handle cancellations on the same call.** The agent finds the caller's upcoming events by email and cancels the one they name.
For example, a solar installer's inbound agent qualifies the caller, checks the sales team's consultation event type for this week, books Thursday 2pm with the caller's email, and the rep's calendar fills itself.
## Prerequisites
* A Calendly account that owns the event types you want to book. The token identifies one Calendly user, and Retell books and reads **that user's** event types and scheduled events.
* A **paid Calendly subscription** for booking. Availability checks, lookups, and cancellations work on any plan, but creating bookings uses Calendly's Scheduling API, which Calendly restricts to paid subscriptions (as of August 2026).
## Step 1: Create a personal access token
In Calendly, go to **Integrations & apps** and open the **API & webhooks** tile. On **Your personal access tokens**, click **Create a token**, name it something descriptive, for example `Retell AI`, create it, and copy it right away; Calendly shows the token only once.
As Calendly's own banner warns, a token created by an **admin** grants access to Calendly data across the organization. Retell only reads and books against the token's own user; if you want to limit what the token can reach, create it from a dedicated non-admin account.
## Step 2: Connect Calendly in Retell
In the Retell Dashboard, open **Integrations**, select the **Available** tab, find **Calendly**, and click **Connect** (**Add Account** if a connection already exists).
Fill in the fields:
| Field | Value |
| ------------------- | --------------------------------------------------------------- |
| **Connection name** | Alias for this connection; prefilled with `Calendly - API key`. |
| **API Key** | The personal access token from Step 1. |
Click **Connect** (**Add Account** if a connection already exists). Retell tests the token by fetching the Calendly user it belongs to.
On success the connection appears on the **Connected** tab. From here, add tools to an agent: see [Calendly agent functions](/integrations/calendly-functions) for what each tool does and how it's configured.
## Troubleshooting
Confirm you pasted a **personal access token**, not an OAuth client secret or a webhook signing key, and that it hasn't been revoked in Calendly.
Retell flags a connection as errored when Calendly rejects the token, usually because it was revoked, or because Calendly invalidates tokens when the account's password or email changes. Open the connection's settings, paste a current token, and click **Reconnect**.
## FAQ
Event types owned by the Calendly user whose token you connected. To book for several team members, connect a token per user (multiple connections are fine) or use a shared account that owns the event types.
## Next steps
Check availability, book appointments, and look up or cancel events mid-conversation.
See every provider Retell connects to and how integration tools work.
The other calendar option, with rescheduling support.
