> ## 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.

# Acuity Scheduling integration

> Set up the Acuity Scheduling Cometly integration with a webhook so each booked appointment is tied to the ad or channel that produced it.

The Acuity Scheduling Cometly integration connects [Acuity Scheduling](https://acuityscheduling.com/) to Cometly with a webhook, a URL that Acuity sends data to each time a new appointment is scheduled. Each booking arrives in Cometly as an event (a tracked action such as a lead or a booked call), ready for tracking and attribution.

Booked appointments are often the conversion your ads are paid to produce. With the booking in Cometly and the invitee's email captured on your thank you page, you can see which ad or channel each appointment came from.

## Before you start

For the Acuity Scheduling integration to work properly, you need all three of these:

* A thank you page that Acuity redirects to when a new appointment is booked
* The custom script from step 1 placed in Acuity
* A Cometly webhook URL placed in Acuity

The thank you page also needs the Cometly pixel (the tracking script that records visits to your site), because the pixel is what reads the email from the URL. See [Install and verify the Cometly pixel](https://docs.cometly.com/getting-started/install-pixel.md).

## Step 1: Pass the email to your thank you page

For Cometly to track the booking, your Acuity Scheduling form must redirect to a thank you page with the invitee's email in the URL. This is a requirement: without it, the integration does not work properly. To learn how the Cometly pixel reads the `email=` URL parameter on a thank you page, see [Pass the email to a thank you page](https://docs.cometly.com/support/troubleshooting/form-tracking/pass-email-to-thank-you-page.md).

1. In your Acuity Scheduling account, go to **Integrations** and select **Custom Conversion Tracking**.

   ![Acuity Scheduling Integrations page with the Custom Conversion Tracking card highlighted](https://mintcdn.com/cometly/2fSDFk1g6ELl9hsV/images/integrations/platforms/acuity-scheduling/01.webp?fit=max\&auto=format\&n=2fSDFk1g6ELl9hsV\&q=85\&s=1f2c217913e84aec3d0acee176c55e89)

2. Take the code below and replace `https://www.website.com/thank-you` with the URL of your thank you page.

   ```html theme={null}
   <script type="text/javascript">
   window.top.location = 'https://www.website.com/thank-you?email=%email%';
   </script>
   ```

   For example, if your thank you page is `https://www.cometly.com/thank-you`, the code looks like this:

   ```html theme={null}
   <script type="text/javascript">
   window.top.location = 'https://www.cometly.com/thank-you?email=%email%';
   </script>
   ```

3. Paste the edited code into Acuity and click **Save Settings**.

## Step 2: Create a webhook event in Cometly

1. In Cometly, click **Events Manager** in the left sidebar, then click **Create Event**.
2. Under **App / Integration**, select **Webhooks**.
3. Pick the event you want to track (or create a new one) and click **Create**.
4. On the next page, click **Copy** next to **Your webhook URL**.

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

For the full walkthrough, see the [Cometly webhooks guide](https://docs.cometly.com/integrations/webhooks.md).

## Step 3: Add the Cometly webhook to Acuity Scheduling

A webhook in Acuity Scheduling sends data to an endpoint, in this case Cometly, each time a new appointment is scheduled.

1. In Acuity Scheduling, go to **Integrations**.

2. Select **Webhooks**.

   ![Acuity Scheduling Integrations page with the Webhooks card highlighted](https://mintcdn.com/cometly/2fSDFk1g6ELl9hsV/images/integrations/platforms/acuity-scheduling/02.webp?fit=max\&auto=format\&n=2fSDFk1g6ELl9hsV\&q=85\&s=eb315fa6f83ed54d69827ddcce4faf4b)

3. Paste your Cometly webhook URL into the **New Appointment Scheduled** field and click **Save Settings**.

   ![Acuity Scheduling Webhooks panel with the New Appointment Scheduled field highlighted](https://mintcdn.com/cometly/2fSDFk1g6ELl9hsV/images/integrations/platforms/acuity-scheduling/03.webp?fit=max\&auto=format\&n=2fSDFk1g6ELl9hsV\&q=85\&s=71243cbf9360e75557393449a2323784)

## Step 4: Map the webhook data in Cometly

Back in Cometly, click **Check for Data**, then finish the event setup. The [Cometly webhooks guide](https://docs.cometly.com/integrations/webhooks.md) explains how to:

* Select a received record to map from
* Map the webhook data to the appropriate Cometly fields
* Set up filters so only the data you want is tracked

Once the event is active, your Acuity Scheduling appointments are sent to Cometly.

## Check it worked

Open **Events Manager** in Cometly. Your webhook event shows a switch that is turned on in the **Status** column, which means it is active and new appointments are being tracked.

## Frequently asked questions

### Does Cometly have a native Acuity Scheduling integration?

No. You connect the two with a webhook: Acuity Scheduling sends each new appointment to a Cometly webhook URL, and you map the data to Cometly fields. The script from step 1 passes the invitee's email to your thank you page so the booking can be linked to the visitor's journey.

### Which Acuity Scheduling fields do I need to map in Cometly?

**Email** and **Event Time** are required. If the data from Acuity has no event time, choose **The time we receive the event** for **Event Time**, and Cometly uses the time the event arrives. You can map more fields, such as first name, last name and phone number, to enrich the contact in Cometly.

### Why is my test Acuity Scheduling appointment 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, activate the event, then book a new test appointment.

## Next steps

* [Set up mapping, filters and activation in the Cometly webhooks guide](https://docs.cometly.com/integrations/webhooks.md)
* [Learn how the pixel reads the email on a thank you page](https://docs.cometly.com/support/troubleshooting/form-tracking/pass-email-to-thank-you-page.md)
* [Understand how events work in Cometly](https://docs.cometly.com/guides/events/how-events-work.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.