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

# Paperform integration

> Set up the Paperform Cometly integration with a webhook, so each form submission is tracked as an event and tied to the ad that produced it.

The Paperform Cometly integration works through a webhook, a message Paperform sends to Cometly each time a form is submitted. You create a webhook event in Cometly, paste its webhook URL into your Paperform form, then map the submission data to Cometly fields. An event is an action Cometly tracks, such as a form submission, a lead or a purchase.

This matters because Cometly can only attribute the submissions it receives. Once Paperform sends them, you can see which campaign, ad set and ad produced each lead.

## Before you start

If you use Paperform forms on your website, make sure the Cometly pixel (the tracking script on your website) is set up on them first. Follow the [Paperform form tracking guide](https://docs.cometly.com/integrations/forms/paperform.md) to complete the required steps.

## Get your Cometly webhook URL

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

   ![Receive Data step of a Cometly webhook event for Lead data, with the Your webhook URL field, an arrow pointing to the Copy button and the Check for Data button below](https://mintcdn.com/cometly/alvP4_0ekdK-CBm_/images/integrations/platforms/paperform/04.webp?fit=max\&auto=format\&n=alvP4_0ekdK-CBm_\&q=85\&s=ec51ce4a4ec9bdaa801a9f373d8b5560)

For more detail on each step, see the [Cometly webhooks guide](https://docs.cometly.com/integrations/webhooks.md).

## Add the webhook in Paperform

1. Open your form in Paperform and select **After Submission** in the top menu bar.

2. Under **After Submission**, select **Integrations & Webhooks**.

   ![Paperform editor with the After Submission menu open and Integrations and Webhooks highlighted](https://mintcdn.com/cometly/alvP4_0ekdK-CBm_/images/integrations/platforms/paperform/01.webp?fit=max\&auto=format\&n=alvP4_0ekdK-CBm_\&q=85\&s=5841bb214db9e4d2c013654441cca18f)

3. Scroll down to the **Webhooks** section and click **Add Webhook**.

   ![Paperform Webhooks section with an arrow pointing to the Add Webhook button](https://mintcdn.com/cometly/alvP4_0ekdK-CBm_/images/integrations/platforms/paperform/02.webp?fit=max\&auto=format\&n=alvP4_0ekdK-CBm_\&q=85\&s=04cc18861b975e023d7501c67822608c)

4. In the **New Webhook** window, set the following, then click **Create**:

   * **Webhook URL**: paste the Cometly webhook URL you copied.
   * **Triggered on**: select the event, such as `New Submission`.

   ![Paperform New Webhook window with the URL field and Triggered on set to New Submission](https://mintcdn.com/cometly/alvP4_0ekdK-CBm_/images/integrations/platforms/paperform/03.webp?fit=max\&auto=format\&n=alvP4_0ekdK-CBm_\&q=85\&s=c2f7a6e896adad390b253c9ba09cf676)

## Finish the setup in Cometly

Once the webhook is configured in Paperform, go back to the event in Cometly and click **Check for Data**. Then follow the [Cometly webhooks guide](https://docs.cometly.com/integrations/webhooks.md) to:

* Select the record Paperform sent.
* Map the webhook data to the matching fields in Cometly (**Email** and **Event Time** are required).
* Set up filters so only the data you want is tracked.
* Activate the event.

After these steps, your Paperform submissions are sent to Cometly for tracking and attribution.

## Check it worked

In **Events Manager**, your Paperform webhook event shows a switch that is turned on in the **Status** column. Submit your Paperform form again, then open the **Events Log** tab: the submission appears there within 60 seconds, with **SUCCESS** in the **Details** column.

## Frequently asked questions

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

The submission 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 Paperform test submission not showing in 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 the form again.

### What if my Paperform submission has no event time to map?

**Event Time** is required, but it does not have to come from Paperform. Choose **The time we receive the event** for **Event Time**, and Cometly uses the time the submission arrives.

## Next steps

* [Follow the full Cometly webhooks guide](https://docs.cometly.com/integrations/webhooks.md)
* [Add the Cometly pixel to a Paperform form](https://docs.cometly.com/integrations/forms/paperform.md)
* [Use the Events Log to check incoming events](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)

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.