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

# Cal.com integration

> Set up the Cal.com Cometly integration with a webhook so every booked meeting is tied to the ad or traffic source that produced it.

The Cal.com Cometly integration runs on a webhook, a URL that Cal.com sends data to each time a meeting is booked. Cometly does not have a native Cal.com integration. You connect the two with a Cal.com webhook that sends each booking to a Cometly webhook URL, where it is saved as an event (a tracked action such as a lead or a scheduled call).

Booked meetings are often the result your ads are paid to produce. Once bookings reach Cometly, you can see which ad, campaign or traffic source each demo, sales call or consultation came from.

## Why track Cal.com bookings in Cometly

Cal.com bookings are often a key conversion point for demos, sales calls and consultations. Setting this up correctly allows Cometly to:

* Attribute bookings to ads and UTMs
* Match booked meetings to user email addresses
* Send accurate conversion events to ad platforms like Meta Ads

[Setting up a Cal.com calendar for tracking with Cometly](https://www.loom.com/embed/67ec84c308cd4d0caaad43a9859e42b3)

## Before you start

* Install the Cometly pixel (the tracking script that records visits to your site) on your site, including the success or thank-you page you redirect to after a booking. See [Install and verify the Cometly pixel](https://docs.cometly.com/getting-started/install-pixel.md).

## Step 1: Open your Cal.com event type

1. Log in to your **Cal.com** account.
2. Go to **Event Types**.
3. Click the specific event you want to track.

## Step 2: Require email on the booking page

1. Open **Advanced Scheduling Options**.
2. Make sure the **Email address** field is enabled and required on the booking form.

> [!WARNING]
>
> Email is required for Cometly to match the booking back to ad clicks. Name and phone number are optional but recommended.

## Step 3: Enable redirect on booking

1. Scroll down to the **Redirect on Booking** section.
2. Toggle **Redirect on booking** on.
3. Enter your success or thank-you page URL (for example `https://example.com/booking-confirmed`).
4. Enable **Forward parameters** (email, name and so on).

> [!TIP]
>
> Forwarding parameters passes the user's email to the success page so Cometly can associate the booking with ad attribution data.

## Step 4: Create a webhook in Cal.com

1. In the same event, go to **Webhooks**.
2. Click **New Webhook**.
3. Remove any pre-selected triggers.
4. Select **Booking Created** as the trigger.
5. Leave the **Subscriber URL** empty for now.

## Step 5: Create the event in Cometly

1. In Cometly, click **Events Manager** in the sidebar.
2. Click **Create Event**.
3. Under **App / Integration**, select **Webhooks**.
4. Select the event name:
   * Use **Schedule** (recommended), or
   * Click **Create New Event** to create a custom event for a specific calendar.
5. Optionally add an event description, for example "Cal.com booking via webhook".
6. Click **Create**.

## Step 6: Copy the Cometly webhook URL

1. In the Events Manager, click **Configure** on the event you just created.
2. Next to **Your webhook URL**, click **Copy**.

![Receive Data step of a Cometly webhook event, with the end of the Your webhook URL field blurred, an arrow pointing at the Copy button and the Check for Data button below](https://mintcdn.com/cometly/2fSDFk1g6ELl9hsV/images/integrations/platforms/cal-com/01.webp?fit=max\&auto=format\&n=2fSDFk1g6ELl9hsV\&q=85\&s=53d18e809f06081b32d98bd867209c4f)

## Step 7: Connect the webhook to Cal.com

1. Go back to your Cal.com webhook setup.
2. Paste the Cometly webhook URL into the **Subscriber URL** field.
3. Click **Ping Test**.
4. Confirm the webhook test passes.

## Step 8: Map fields in Cometly

1. Return to Cometly and click **Check for Data**.
2. Select the incoming webhook record and click **Continue With Selected Record**.
3. Map the required fields: **Email** and **Event Time**.
4. Optionally click **Add Field** and map:
   * **Full Name**
   * **Phone** (if sent)
5. Click **Save & Continue**.
6. On the **Filtering** step, click **Activate**.

> [!NOTE]
>
> If a field (like phone number) is not included in the webhook payload, you can safely skip it.

For more detail on mapping, formatting and filters, see [Cometly webhooks](https://docs.cometly.com/integrations/webhooks.md).

## Step 9: Confirm the webhook is saved in Cal.com

Make sure the webhook is saved and enabled in **Cal.com** after testing.

Once saved, bookings for this Cal.com event are tracked in Cometly and attributed correctly.

Repeat this process for each of the other events in your Cal.com account that you want to track.

## Check it worked

Open **Events Manager** in Cometly. Your webhook event shows a switch that is turned on in the **Status** column. Make a test booking in Cal.com, then open the **Events Log** tab: the booking appears there within 60 seconds, with **SUCCESS** in the **Details** column.

## Frequently asked questions

### How long does it take for a Cal.com booking to show up in Cometly?

The booking shows in the Events Log within 60 seconds of Cal.com sending it. It can take up to 15 minutes to appear in the reporting areas, such as the Report Builder or Ads Manager.

### Why is my test Cal.com booking not showing in Cometly reports?

Test data sent before the webhook was activated is not processed and does not appear in your reports. Finish the mapping, click **Activate**, then make a new test booking.

### What if the Cal.com webhook data has no event time to map?

Choose **The time we receive the event** for **Event Time**. Cometly then uses the time the booking arrives as the event time.

## Next steps

* [Set up mapping, formatting and filters in the Cometly webhooks guide](https://docs.cometly.com/integrations/webhooks.md)
* [Use the Events Log to check incoming bookings](https://docs.cometly.com/support/troubleshooting/general/event-log.md)
* [Learn how events work in Cometly](https://docs.cometly.com/guides/events/how-events-work.md)
* [Install and verify the Cometly pixel](https://docs.cometly.com/getting-started/install-pixel.md)

Still have questions or need a hand? We're happy to help. Reach our team at [support@cometly.com](mailto:support@cometly.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.