Skip to Content

Cal.com

Let your agent check availability and book, reschedule, or cancel appointments in your Cal.com  account — works with Cal.com cloud or a self-hosted instance.

Setup

  1. In Cal.com, open Settings → Developer → API keys and create an API key.
  2. Integrations → Add integration → Cal.com.
  3. Name it (e.g. “Cal.com booking”).
  4. Paste the API key. It’s stored encrypted and never shown again.
  5. Optionally set:
    • a base URL — leave blank for Cal.com cloud, or point it at your own self-hosted instance (e.g. https://cal.yourcompany.com/api);
    • a default event type ID (the numeric id to use when a call doesn’t specify one);
    • a timezone used to format times.
  6. Click Add & discover tools.

Cal.com requires an email address for every booking, so the agent asks the caller for one.

Tools

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

  • …_list_event_types — list the bookable services and their durations
  • …_get_available_slots — open slots for an event type in a time window
  • …_create_booking — book an appointment (needs the caller’s name, email, and a time)
  • …_reschedule_booking — move an existing booking to a new time
  • …_cancel_booking — cancel a 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.

Self-hosting

If you run your own Cal.com instance, set the base URL to your instance’s API root. Leave it blank to use Cal.com cloud (https://api.cal.com).

Last updated on
Quickstart