Skip to main content

Cal.com: Connect Your Calendar

This guide walks you through connecting your Cal.com account to AutoRev so your AI receptionist can check real-time availability and book appointments directly on your Cal.com calendar.

Estimated time: 5 minutes.

Why connect Cal.com​

  • Your AI receptionist checks live Cal.com availability before offering times to callers. No more double-booking.
  • Bookings made by the AI appear instantly on your Cal.com calendar, with the customer's contact info, call notes, and any custom fields.
  • Cancellations and reschedules sync both ways. If the customer reschedules through their Cal.com confirmation email, your AI knows the next time they call.
  • The AI uses your existing Cal.com event types, so the slot length, buffer time, and questions your customers already see stay exactly as you configured them.

Step 1: Important: v2 API only​

Cal.com runs two API versions: v1 (legacy) and v2 (current).

AutoRev only supports Cal.com v2. Cal.com formally deprecated v1 in April 2026 and will shut it down completely. If you generate a v1 token, AutoRev will reject it with an error like "API version not supported."

When you generate your API key in Cal.com, make sure you are on the v2 developer page. The URL will mention developer and v2. Cal.com v2 tokens are Bearer tokens that look like a long string and pair with a required header (cal-api-version: 2024-08-13) that AutoRev sets for you automatically.

Step 2: Get your Cal.com API key​

  1. Log into Cal.com at app.cal.com.

  2. Click your profile picture in the top right.

  3. Click Settings.

  4. In the left sidebar, click Developer.

  5. Click API Keys.

  6. Click Add or Generate New API Key.

  7. Name it "AutoRev AI Receptionist".

  8. Set an expiration. Cal.com lets you choose 30 days, 90 days, 1 year, or never. Choose Never expires for production use (you can revoke it any time). If you choose a shorter expiry, you will need to regenerate the key when it expires.

  9. Click Save.

  10. Copy the API key shown on screen. Cal.com only shows this once. If you lose it, you have to delete the key and create a new one.

Step 3: Find your event_type_id​

Cal.com calls each bookable type of meeting an event type. You probably have one or more set up: "30-minute Consultation", "Service Call", "AI Audit", etc.

Your AI receptionist will use a specific event type for bookings (so the slot length and buffer rules apply correctly). You need to tell AutoRev which one.

  1. In Cal.com, click Event Types in the left sidebar.
  2. Click on the event type you want the AI to use for bookings.
  3. Look at the URL bar of your browser. It will look like: 
    https://app.cal.com/event-types/1234567?tabName=setup
  4. The number after event-types/ is your event_type_id. In the example above, it is 1234567.

If you have multiple event types you want the AI to use (e.g., one for new customer consults and one for return customer service calls), note all of them. The AI can route to different event types based on call context.

Step 4: Required permissions​

Cal.com API keys do not have separate scope settings. A single API key grants:

  • Read all event types
  • Read availability across all event types
  • Create bookings
  • Cancel and reschedule bookings
  • Read your booking list

That is everything AutoRev needs. There is nothing extra to enable.

Step 5: Connect to AutoRev​

Once you have your Cal.com API key and event_type_id:

In the AutoRev dashboard, go to Settings > Integrations, open the card for this integration, paste your credentials, and click Connect. Credentials are validated live against the provider before anything is saved. (If you use AutoRev through the Claude connector, you can also just ask Claude to connect it for you.)

How to test the connection​

After connecting, the card shows the live connection state. The connect step already validated your credentials with a real API call, so a green card means you are live.

  • Your event type details (to confirm the event_type_id is valid).
  • Your availability for the next 7 days.
  • Your most recent booking.

If all three come back, you are live.

Common issues​

"API version not supported" error You generated a v1 API key. Cal.com v1 is deprecated and AutoRev does not support it. Delete the v1 key and create a new key in the Developer > API Keys section of Cal.com's current dashboard (which only generates v2 keys now).

"Unauthorized" or "Invalid API key" error The key was copied with a leading or trailing space, or the key has expired. Regenerate in Cal.com and reconnect.

"Event type not found" error The event_type_id you entered does not exist or belongs to a different Cal.com account than the API key. Double-check: the event_type_id is the number after event-types/ in your URL, not the name of the event type and not your user ID.

The AI says "no availability this week" but you have plenty of open slots Cal.com availability is driven by the schedule attached to the event type. If the event type's schedule is set to "Working Hours" but you have not configured working hours, or if all your time slots are blocked by buffer or minimum-notice rules, no slots will be returned. Open the event type in Cal.com, click Availability, and confirm the schedule has real working hours set. Also check the Limits tab for things like "Minimum booking notice" (set this to 2 hours, not 2 days, if you want same-day bookings).

Bookings show up in Cal.com but the customer's contact info is missing The AI passes the caller's name and phone, but Cal.com's event type may have custom required questions ("What's your address?", "What service do you need?") that the AI did not answer. Two options: (a) make those questions optional in Cal.com, or (b) ask Claude to map specific questions to the AI's call-data fields.

Cal.com sends double confirmation emails (one from Cal.com, one from AutoRev) This is configurable. By default, both Cal.com and AutoRev send a confirmation. To suppress Cal.com's: in Cal.com event type settings, turn off Email confirmations under Workflows. To suppress AutoRev's: ask Claude "do not send my AutoRev confirmation when Cal.com is the booking source."

Need help?​

Email support@autorev.ai or ask Claude "I'm having trouble with my Cal.com integration."