Calendar

Connect a Cal.com calendar with your AI agent. This allows the agent to check available appointments and make bookings directly for your callers.

Currently, the integration supports retrieving available appointments as well as direct booking. More functions will be added gradually.

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 to

2

Go to Settings → Security → API Keys

3

Create a new API key

4

Save the key securely

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 in sipgate

1

Open your AI agent

and navigate to the Calendar

2

Click "Add"

to open the setup dialog

3

Enter your API key

and click Next

4

Select the appropriate mode, the API region, and, if necessary, additional IDs

See table

5

Click Save

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 in "Organization" mode	The ID of your Cal.com organization
Team ID	Only in "Team" mode, optional in "Organization"	The ID of your Cal.com team

Choose mode

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

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

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 correct, check the URL in your browser when you are logged in to Cal.com. If you use cal.eu, select the EU region.

Edit configuration

After setup, you can adjust the Mode, the API region and the API token separately at any time using the edit buttons.

Good to know

• Your API key is stored encrypted.

• The AI agent checks availability in your Cal.com calendar for each call.

• Changes to the configuration take effect immediately.

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

In the Enterprise plan more complex appointment and process logic can also be implemented. Learn more.