> ## Documentation Index
> Fetch the complete documentation index at: https://voiceai-docs.theclevermarketing.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/unicornpublicies/7bLDmb_pHEh6jn9G/resources/calcom-api-key.png?fit=max&auto=format&n=7bLDmb_pHEh6jn9G&q=85&s=c6f989069256cdda7555de8aa70b6d98" 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/unicornpublicies/7bLDmb_pHEh6jn9G/resources/calcom-connect.png?fit=max&auto=format&n=7bLDmb_pHEh6jn9G&q=85&s=e5d4c8619cfe417c4a1a7d727223112a" 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/unicornpublicies/7bLDmb_pHEh6jn9G/resources/calcom-sync.png?fit=max&auto=format&n=7bLDmb_pHEh6jn9G&q=85&s=f37c12471074029139830f5e45881a04" 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