Cal.com

What it is

Cal.com is an open-source scheduling platform (a Calendly alternative). The integration connects with a personal API key and lets a bot flow list a user's event types, check available slots, and create or cancel bookings right from the conversation — for example, letting the bot book a client into a consultation slot on its own.

Requirements

A Cal.com account with at least one event type configured.
An API key from account settings — Settings → Developer → API keys.

How to connect

Sign in to Cal.com and open Settings → Developer → API keys.
Click Add and copy the generated key (test keys start with cal_, live keys with cal_live_).
In the constructor, open Integrations → find the Cal.com card → Connect.
Paste the key into the connection field and save.
Verify the connection with Test connection — it calls the list-event-types endpoint.

Available operations

Operation	What it does
List event types	Returns event types (id, title, slug, duration) — the key owner's, or a given `username`'s
Get available slots	Returns free time windows for an event type within a date range and timezone
Create booking	Books a slot for an attendee (name, email, timezone, start time)
Cancel booking	Cancels a booking by its UID, with an optional reason

Limits

Cal.com API rate limit: 120 requests per minute per key (higher limits available on request to Cal.com).
Each operation calls a fixed API version (cal-api-version) — this is an internal detail of the integration and needs no configuration.
Times are passed in ISO 8601 format (UTC with a trailing Z is recommended).

Notes

Booking almost always needs an event_type_id first — get it from the "List event types" operation and pass it via a variable into the next steps of the flow.

The API key is tied to a specific Cal.com account: operations without a username return/act on the key owner's own data.