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: 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.
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.
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).
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.
Calendly's personal access tokens page, with the Create a token button highlighted.
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.
In the Retell Dashboard, open Integrations, select the Available tab, find Calendly, and click Connect (Add Account if a connection already exists).
2
Enter the token
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.
The Calendly connection dialog: paste the personal access token as the API key.
Click Connect (Add Account if a connection already exists). Retell tests the token by fetching the Calendly user it belongs to.
3
Verify it worked
On success the connection appears on the Connected tab. From here, add tools to an agent: see Calendly agent functions for what each tool does and how it’s configured.
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.
The connection errored after working for a while
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.
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.
