> ## Documentation Index
> Fetch the complete documentation index at: https://docs.callivox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cal.com Appointment Scheduling

> Enable your AI assistant to schedule appointments using Cal.com

Enable your AI assistant to schedule meetings using Cal.com integration. The system automatically configures booking fields for you.

## Setup

### 1. Get API Key

1. Log in to [Cal.com](https://cal.com/)
2. Go to **Settings** → **Developer** → **API Keys**
3. Create a new API key and copy it

<img height="200" src="https://mintcdn.com/haconsultancy/vOrZKWrhFi0H4wbx/resources/calcom-api-key.png?fit=max&auto=format&n=vOrZKWrhFi0H4wbx&q=85&s=ddab03a69dcc9c87658fe49a457657bd" data-path="resources/calcom-api-key.png" />

### 2. Connect Cal.com

1. In your assistant settings → **Tools** tab → **Appointment Scheduling**
2. Select **Cal.com** from calendar type
3. Paste your API key
4. Select an event from the dropdown

<img height="200" src="https://mintcdn.com/haconsultancy/vOrZKWrhFi0H4wbx/resources/calcom-connect.png?fit=max&auto=format&n=vOrZKWrhFi0H4wbx&q=85&s=bb67bb588bacd3a1b045e0b2b5a53290" data-path="resources/calcom-connect.png" />

### 3. Sync Event

Click the **"Sync Event"** button to automatically configure booking fields.

<img height="200" src="https://mintcdn.com/haconsultancy/vOrZKWrhFi0H4wbx/resources/calcom-sync.png?fit=max&auto=format&n=vOrZKWrhFi0H4wbx&q=85&s=7bc1b23e79cff33844fdca4dce020642" data-path="resources/calcom-sync.png" />

<Check>
  The sync configures: name, email, phone (required) + notes (optional). All other fields become optional.
</Check>

## Multiple Calendars

Click **"+"** next to Appointment Scheduling to add more calendars (e.g., 15min, 30min meetings).

## Email Setup

For calendar invites to work:

1. Define `email` in assistant [input variables](/ai-assistants/settings/prompt-and-tools#call-variables)
2. Pass customer email when creating leads

The phone number is automatically included after sync.

## Troubleshooting

**Invalid API Key:** Verify it's active in Cal.com settings and includes `cal_live_` prefix

**Sync Failed:** Click **"Troubleshoot"** button to reset fields

**No Invites Sent:** Ensure `email` variable is defined and passed with leads

**Field Errors:** Use "Troubleshoot" to reset. Only name, email, phone should be required.

<Note>
  For detailed troubleshooting, see [Cal.com Issues](/troubleshooting/cal-com).
</Note>

## Testing

1. Make a test call and request a meeting
2. Verify booking appears in Cal.com
3. Check calendar invitation email was received