Calendar

Connect a Cal.com calendar to 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. Additional functions will be added gradually.

Prerequisites

• 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

Log in at app.cal.com in

2

Go to Settings → Security → API Keys

3

Create a new API key

4

Store the key securely

API keys are valid for 30 days by default. In the Cal.com settings, you can adjust the validity or create an indefinitely valid key.

Set up calendar integration in sipgate

1

Open your AI agent

and navigate to the tab Calendar

2

Click "Add"

to open the setup dialog

3

Enter your API key

and click on Continue

4

Choose 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" mode	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	Organization-level access — 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're unsure which region is correct, check the URL in your browser when you're logged in to Cal.com. If you use cal.eu, select the EU region.

Edit configuration

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

Good to know

• Your API key is stored encrypted.

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

• Changes to the configuration take effect immediately.

• If you delete the integration, the agent will no longer be able to check or book appointments.

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