Skip to Content

Calendly

Let your agent check availability and book or cancel appointments in your Calendly  account — a good fit if your booking already lives in Calendly.

Booking by phone requires the business to be on a paid Calendly plan. Calendly’s API only allows programmatic bookings on paid plans; on a free plan the agent can still check availability, but create_booking will fail. Calendly also requires an email address for every booking, so the agent asks the caller for one.

Setup

  1. In Calendly, open Integrations → API & webhooks and create a Personal Access Token.
  2. Integrations → Add integration → Calendly.
  3. Name it (e.g. “Calendly booking”).
  4. Paste the Personal Access Token. It’s stored encrypted and never shown again.
  5. Optionally set a default event type (the event type URI to use when a call doesn’t specify one) and a timezone used to format times.
  6. Click Add & discover tools.

Tools

Once connected, the agent can (prefixed with your integration’s slug):

  • …_list_event_types — list the bookable services and their durations
  • …_get_available_times — open times for an event type (max 7 days ahead)
  • …_create_booking — book an appointment (needs the caller’s name, email, and a time; requires a paid Calendly plan)
  • …_cancel_booking — cancel an existing booking
  • …_find_bookings — find a caller’s upcoming bookings by email

Enable the ones you want per agent version in the builder’s Integration tools card.

Rescheduling

Calendly has no reschedule endpoint. To move a booking, the agent cancels the existing one with cancel_booking and creates a new one with create_booking — the tool descriptions tell it to do exactly that.

Last updated on
Quickstart