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

# Kit (formerly ConvertKit) integration

> Set up the Kit (ConvertKit) integration with Cometly so each form signup becomes an event you can trace back to the ad that produced it.

The [Kit](https://partners.convertkit.com/7ahlcnhzqtfy) (formerly ConvertKit) integration with Cometly sends your Kit form submissions to Cometly. You map each Kit form to a Cometly event (an action Cometly records, such as a lead or a newsletter signup), and every new signup through that form is recorded as that event.

This matters because Cometly attributes each of those events to the ad that brought the subscriber in. You can then see which campaigns and ads produce your signups, not only which ones get clicks.

## Before you start

* You have a Kit account with at least one form, and you can open its **Settings**.
* The Cometly pixel (the tracking script you install on your site) is on the pages where your Kit forms appear. See [Install the Cometly pixel](https://docs.cometly.com/getting-started/install-pixel.md).

## Step 1: Copy your API secret in Kit

In your Kit account, click your profile in the top right and then click **Settings**.

On the Settings menu, click **Developer**.

Copy the **API Secret** key.

> [!WARNING]
>
> You must use the **API Secret** key, not the API key.

## Step 2: Activate the Kit integration in Cometly

In Cometly, click **Integrations** in the sidebar. Find the **Kit** card (category **Web Builders**) and click **Connect**.

![Cometly Apps and Integrations page on the Web Builders category, with an arrow pointing at the Connect button on the Kit card](https://mintcdn.com/cometly/gJhojf-axy7BVk83/images/integrations/platforms/kit/04.webp?fit=max\&auto=format\&n=gJhojf-axy7BVk83\&q=85\&s=e1974d4e1f78e2108e051ec01862acd5)

Paste the API secret into the **Kit API secret** field and click **Activate**.

> [!NOTE]
>
> Once a secret is saved, Cometly does not show it again. The field stays empty with the hint "A secret is saved. Enter a new one to replace it". Leave it empty to keep the saved secret.

## Step 3: Map Kit forms to Cometly events

Once the integration is activated, all your existing Kit forms appear under **Map Kit forms to Cometly events**. Any new form you create in Kit is added to this list automatically.

For each form under **Kit Forms**, choose the Cometly event it should send under **Cometly Events**. Forms left on **Not mapped** send nothing.

Click **Save**.

## Check it worked

After you click **Save**, the page reloads with each form still showing the event you chose. Subscribe through one of your mapped Kit forms with a test email address. Then, in Cometly, click **Events Manager** in the sidebar and open the **Events Log** tab: the signup is listed there under the event you mapped the form to. See [Use the Events Log](https://docs.cometly.com/support/troubleshooting/general/event-log.md) for what each status means.

## Frequently asked questions

### Why are my Kit forms not showing up in Cometly?

The form list only appears after a valid API secret is saved. If you pasted the API key instead of the **API Secret**, Kit rejects it and Cometly shows an error instead of your forms. Copy the **API Secret** from the **Developer** page in Kit, paste it into the **Kit API secret** field and save again.

### How do I stop a Kit form from sending events to Cometly?

Open the Kit integration in Cometly, set that form to **Not mapped** under **Cometly Events** and click **Save**. Cometly removes its connection to that form in Kit, so new signups through it are no longer sent.

### What does Cometly receive when someone submits a Kit form?

Kit notifies Cometly each time someone subscribes through a mapped form, and Cometly records the event you chose for that form. The subscriber's email address is required: Cometly uses it to connect the signup to the right contact.

## Next steps

* [How events work](https://docs.cometly.com/guides/events/how-events-work.md)
* [Manage custom events](https://docs.cometly.com/guides/events/custom-events.md)
* [Use the Events Log](https://docs.cometly.com/support/troubleshooting/general/event-log.md)
* [Browse all integrations](https://docs.cometly.com/integrations/overview.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.