Calendar

Connect a Cal.com calendar to your agent. This way, your agent checks available appointments and books directly for your callers.

Note: Currently, the integration supports retrieving available appointments as well as direct booking. More features will be added step by step.

Requirements

• a Cal.com account, free or paid

• at least one configured event type in Cal.com

• an API key from your Cal.com account

Create Cal.com API key

1

Sign in at app.cal.com in.

2

Navigate to Settings → Security → API Keys.

3

Create a new API key.

4

Store the key securely.

Note: API keys are valid for 30 days by default. In the Cal.com settings, you can adjust the validity or create a key with unlimited validity.

Set up calendar integration

1

Open your agent and navigate to the Calendar.

2

Click Add to open the setup dialog.

3

Enter your API key and click Next.

4

Choose the appropriate mode, the API region, and, if necessary, additional IDs.

5

Click Save.

Important: Make sure no playbook for appointment requests is active, neither your own nor one from the library. Otherwise, your agent may handle the request via the playbook and not start an appointment booking.

Configuration fields

Field	Required	Description
API token	Yes	Your Cal.com API key (starts with cal_ or cal_live_)
Mode	Yes	Determines which calendar is accessed (see below)
API region	Yes	US or EU — depending on where your Cal.com account is hosted
Organization ID	Only for mode "Organization"	The ID of your Cal.com organization
Team ID	Only for mode "Team", optional for "Organization"	The ID of your Cal.com team

Choose mode

You can find the Team ID and Organization ID in the URL when you open the respective team or organization in Cal.com.

Mode	Description
Personal	Access to your personal Cal.com calendar
Team	Access to a team calendar — requires a Team ID
Organization	Access at organization level — requires an Organization ID, Team ID is optional

API region

Region	URL	Usage
US (Global)	api.cal.com	Default for Cal.com accounts
EU	api.cal.eu	For Cal.com accounts hosted in the EU (GDPR-compliant)

If you are unsure which region is the right one: look at your browser's address bar while you are logged in to Cal.com. If the address is app.cal.eu, choose the EU region. If it is app.cal.com, choose US (Global).

Edit configuration

After setup, you can adjust the Mode, the API region and the API token separately using the edit buttons. Changes take effect immediately.

Good to know

• Do not include any entries about appointments or booking appointments in the customer questions. Otherwise, your agent may treat the matter as a knowledge question instead of using the calendar integration.

• Your API key is stored encrypted.

• Your agent checks availability in your Cal.com calendar with every call.

• If you delete the integration, your agent can no longer check or book appointments.

In the Enterprise plan you can also map more complex appointment and process logic. Learn more.