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

# Gravity Forms integration

> Set up the Gravity Forms Cometly integration: send each form submission to Cometly as an event with a webhook, so you can see which ad produced each lead.

The Gravity Forms Cometly integration works through a **Cometly webhook**, a URL that receives data from another app in real time. Gravity Forms posts each form submission to your Cometly webhook URL, and you map the fields to a Cometly event. An event is an action Cometly tracks, such as a form submission, a lead or a purchase.

This sends submissions straight into your Cometly account, so you can track leads without a third tool in between. Once each submission arrives as an event, you can see which campaign, ad set and ad produced the lead.

## Before you start

* Set up form tracking for your Gravity Forms. Follow the [Gravity Forms form tracking guide](https://docs.cometly.com/integrations/forms/gravity-forms.md).
* Check that your Gravity Forms license includes the Webhooks Add-On. It is typically included in higher-tier licenses. If you do not have it, or you prefer Zapier, use the [Zapier integration](https://docs.cometly.com/integrations/zapier.md) instead.
* Get your Cometly webhook URL. In Cometly, go to **Events Manager**, click **Create Event**, choose **Webhooks** under **App / Integration**, pick the event name and click **Create**. Then click **Configure** next to the new event and copy the URL shown under **Your webhook URL**. The [Cometly webhooks guide](https://docs.cometly.com/integrations/webhooks.md) covers this in detail.

![Receive Data step of a Cometly webhook event, with the Your webhook URL field boxed and an arrow pointing at the Copy button](https://mintcdn.com/cometly/gJhojf-axy7BVk83/images/integrations/platforms/gravity-forms/01.webp?fit=max\&auto=format\&n=gJhojf-axy7BVk83\&q=85\&s=e13698d7e1cc2d7ffab6f00b4105f0d1)

## Connect Gravity Forms to Cometly with a webhook

**1. Install and activate the Webhooks Add-On**

1. In WordPress, go to **Forms** > **Add-Ons**.
2. Find the **Webhooks Add-On** and click **Install** (if it is not already installed).
3. **Activate** the add-on.

**2. Add a new webhook feed**

1. Open the form editor for the form you want to connect.
2. Click **Settings** (under your form name) and select **Webhooks**.
3. Click **Add New** to create a new webhook feed.

**3. Configure the webhook**

1. **Name the feed**: Something like `Cometly Webhook`.
2. **Request URL**: Paste your Cometly webhook URL.
3. **Request Method**: Choose **POST**.
4. **Request Format**: Set to **JSON**.
5. **Header Configuration**: Nothing is required here.
6. **Conditional Logic** (optional): If you only want to send submissions under certain conditions, enable conditional logic and set your rules. Otherwise, leave it disabled.

**4. Save and test**

1. Click **Save Settings**.
2. In Cometly, on the event's **Receive Data** step, click **Check for Data**.
3. Submit a test entry on your Gravity Form.
4. Confirm the submission appears in Cometly.

## Finish the webhook in Cometly

Once the test submission has arrived, finish the event setup in Cometly. The [Cometly webhooks guide](https://docs.cometly.com/integrations/webhooks.md) has detailed instructions for:

* Selecting the test record and continuing.
* Mapping the webhook data to the right Cometly fields.
* Adding filters so only the submissions you want are tracked.
* Activating the event.

After the event is activated, your Gravity Forms submissions are sent to Cometly.

## Check it worked

In [Events Manager](https://app.cometly.com/space/events-manager), your webhook event shows a switch that is turned on in the **Status** column. Submit a new entry on your Gravity Form, then open the **Events Log** tab: the event appears there within 60 seconds, with **SUCCESS** in the **Details** column.

## Frequently asked questions

### How long does it take for a Gravity Forms submission to show up in Cometly?

The event shows in the Events Log within 60 seconds of being sent. It can take up to 15 minutes to appear in the reporting areas, such as the Report Builder or Ads Manager.

### Why is my Gravity Forms test submission missing from my Cometly reports?

Test data sent before the webhook event was activated is not processed and does not appear in your reports. Activate the event first, then submit a new entry on your form and look for it in the **Events Log** tab of **Events Manager**.

### Do I still need the Cometly pixel on my form if I use the webhook?

Yes, set up both. The Cometly pixel (the tracking script on your website) captures page views and the fields your visitors fill in, and the webhook sends the submission to Cometly as an event. The [Gravity Forms form tracking guide](https://docs.cometly.com/integrations/forms/gravity-forms.md) shows how to add the pixel to your form.

## Next steps

* [Map fields, add filters and activate your webhook event](https://docs.cometly.com/integrations/webhooks.md)
* [Use the Events Log to check incoming events](https://docs.cometly.com/support/troubleshooting/general/event-log.md)
* [Add the Cometly pixel to your Gravity Forms form](https://docs.cometly.com/integrations/forms/gravity-forms.md)
* [Send events to Cometly with Zapier instead](https://docs.cometly.com/integrations/zapier.md)
* [Learn 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.