***

title: Cal.com
slug: calcom
---------------------

For clean Markdown of any page, append .md to the page URL. For a complete documentation index, see https://docs.synthflow.ai/llms.txt. For full documentation content, see https://docs.synthflow.ai/llms-full.txt.

## Overview

Cal.com + Synthflow lets your AI voice agents book meetings directly into your Cal.com calendars. Typical outcomes include real‑time booking during live calls, a 24/7 AI receptionist that captures leads after hours, and instant scheduling handoffs to humans.

## Prerequisites

* A Cal.com account with at least one published event type (and access to its Event ID).
* Proper availability configured in Cal.com (hosts, time buffers, timezones, and booking windows).
* A Synthflow agent created and accessible to you.
* Access to Synthflow Actions and the [Real‑Time Booking action](/create-a-real-time-booking-action).

## Set up the integration

### Connect your Cal.com account

Navigate to **Integrations** > **Cal.com** and provide your Cal.com API key.

<Note>
  The Cal.com API keys are located in your Developer Settings. Make sure your key is saved somewhere safe.
</Note>

![](https://files.buildwithfern.com/synthflow.docs.buildwithfern.com/f2572c7291a196341726c791f731975d7b10815e618f04252571155c884f3931/docs/assets/screenshots/calcom_auth.png)

### Link your Calendar Event ID

Upon creating a [Real-Time Booking action](/create-a-real-time-booking-action), you will be asked to provide your Cal.com event ID.

1. Within your Cal.com account, navigate to your calendar event.
2. In the URL, you can find a 6-7 numeric character.
3. Copy it, and provide it to your Real-Time Booking action.
4. Press **Next** and configure your action.
   ![](https://files.buildwithfern.com/synthflow.docs.buildwithfern.com/041135754100e94857a8e0858f2baa8437aa5f0cfbeb9571a16ea8412617d269/docs/assets/screenshots/calcom_event_id.png)

***

## Use‑case examples

* **Real‑time booking during calls**: The agent proposes slots, confirms a time, and instantly creates a Cal.com booking.
* [**24/7 AI receptionist**](https://synthflow.ai/ai-receptionist): Outside business hours, your agent still schedules meetings so you never miss a lead.
* **Qualification + scheduling**: Ask a few qualifying questions before offering times, then book with the right host or event.

***

## Troubleshooting

* **Calendar/event not showing**: Verify the Cal.com event is published and that you pasted the correct Event ID. Make sure the event is visible to the host and not restricted by team settings.
* **Booking not created**: Confirm the Real‑Time Booking action is attached to the agent and that your prompt contains a clear instruction to schedule. Check [call logs](/logs#call-logs) for any errors in booking.
* **No availability returned**: Ensure host calendars are connected in Cal.com and that booking windows/buffers don’t block all times.
* **Wrong time zone**: Confirm the caller’s time zone detection and your event’s default time zone in Cal.com.

***

## FAQs

<AccordionGroup>
  <Accordion title="What happens if the time becomes double‑booked?">
    Cal.com checks live availability at booking time. If a slot becomes unavailable, the agent will offer alternative times and attempt a new booking.
  </Accordion>

  <Accordion title="How are time zones handled?">
    The integration uses the caller’s time zone when available; otherwise it falls back to the event/host defaults configured in Cal.com.
  </Accordion>

  <Accordion title="Can the caller cancel or reschedule?">
    Yes. Cal.com’s confirmation emails include manage links. You can also add a follow‑up flow in your agent to retrieve or modify bookings.
  </Accordion>

  <Accordion title="Does this work with team/round‑robin events?">
    Yes—use team or round‑robin events in Cal.com. The agent will book into whichever host Cal.com assigns per your rules.
  </Accordion>

  <Accordion title="Where do I put the Event ID?">
    When adding the Real‑Time Booking action, select Cal.com and paste the Event ID from your Cal.com event settings.
  </Accordion>

  <Accordion title="Do I need an API key or OAuth?">
    You will be asked to provide your API key once upon connection. Once connected, all actions will require an Event ID.
  </Accordion>
</AccordionGroup>

***

## Further resources

* <a href="https://app.cal.com/apps/synthflow">
    Cal.com Documentation on Synthflow
  </a>
* <a href="https://cal.com">
    Cal.com Dashboard
  </a>