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

# Create and configure events

> Create conversion events in Cometly, connect each one to its data source and test that data arrives, so every lead and sale is tied to an ad.

Events let you track the actions that matter most to your business: someone visits a key page, a new deal is added to your pipeline, or a lead becomes qualified. On this page you create conversion events in Cometly, connect each one to the app that sends its data, and test that the data arrives.

Events are what Cometly attributes to your ads. Once an event receives data, you can see how many times it happened, what it was worth and what it cost for each campaign, ad set and ad, so you know which ads produce leads and sales.

## Create events

We recommend creating all of the events you want to send to Cometly before you start configuring them.

1. In the left sidebar, click [**Setup**](https://app.cometly.com/space-setup).

2. Open step 5, **Create conversion events**.

   ![Setup page on the Setup tab with an arrow pointing at step 5, Create conversion events, in the step list](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/getting-started/events/01.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=e9ca8868620a88c543134d520fefd4d1)

3. Under **App / Integration**, choose the app or integration that will send the data for this event.

   ![Step 5, Create conversion events, with an arrow pointing at the App / Integration dropdown, above the Select Webhooks link and the Create Event button](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/getting-started/events/02.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=6bc1372931a540183acd2af8326fd961)

   If your integration is not listed, click **Select Webhooks**. Webhooks let you send data from any application, map its fields and apply filters.

   Each integration article says which method to choose for that app. See [integrations by platform](https://docs.cometly.com/integrations/overview.md#integrations-by-platform).

4. Under **Events**, select the event name. Pick a default (built-in) event, or choose **Create New Event** to make a custom event. [Learn more about default events and custom events](https://docs.cometly.com/guides/events/how-events-work.md).

5. Optionally enter an event description, then click **Create Event**.

> [!TIP]
>
> You can also create an event from **Events Manager**: click **Create Event**, fill in the same fields and click **Create**.

When you create an event, Cometly generates four metrics for it:

| Metric | What it shows |
| - | - |
| **\{Event}** | The number of times the event happened. |
| **\{Event} Value** | The total value associated with the event. |
| **Cost per \{Event}** | The average cost to generate the event. |
| **\{Event} ROAS** | The return on ad spend for the event. |

> [!NOTE]
>
> **Example:** If you create a custom event called "Deal Created", these metrics appear in your Cometly reporting:
>
> * **Deal Created**
> * **Cost per Deal Created**
> * **Deal Created Value**
> * **Deal Created ROAS**

Repeat these steps for every event you want to track. New events are listed under the form as drafts.

![Drafts to configure section with the Configure Events button and two draft events, each with a Draft badge and a Configure button](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/getting-started/events/03.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=7a1d1238a5bcba4ed8c024a63ed74a3d)

Once you have added all your events, you can configure them. Configuring an event means connecting it to its integration so it receives data whenever that event happens.

## Configure events

If Cometly has no direct integration for the application you want to send event data from, webhooks are the easiest way to send data from it. See [integrations by platform](https://docs.cometly.com/integrations/overview.md#integrations-by-platform).

1. In the left sidebar, click **Events Manager**. (From Setup, the **Configure Events** button takes you to the same page.)

   ![Events Manager page with an arrow pointing at Events Manager in the left sidebar](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/getting-started/events/04.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=842ef3a2251d164570b9c98988157725)

2. Find the event you want to configure and click **Configure**, then follow the steps on screen.

### Configure webhooks

Cometly webhooks let you send event data from any app to Cometly. You can map the data to Cometly fields and set up filters for events.

**Example:** if your payment platform has no direct integration with Cometly, you can still send events like **New Payment**, **New Trial**, **Converted Trial** or **Canceled Subscription** to Cometly using webhooks.

[Learn how to send event data using webhooks](https://docs.cometly.com/integrations/webhooks.md)

### Configure Zapier

Zapier makes it easy to send event data to Cometly from apps without a direct integration.

**Example:** if your CRM has no direct integration with Cometly, you can still send an event such as a deal moving to a new stage to Cometly using Zapier.

[Learn how to send event data using Zapier](https://docs.cometly.com/integrations/zapier.md)

### Send custom event data using webhooks, Zapier or the API

You can send events server-side from a payment platform, CRM or any other back-end system. For a custom event, the `event_name` you send is the key of the custom event, not the name you gave it.

For example, if you named your first custom event Deal Created, you send the server event through the Cometly API or Zapier with the event name `custom_event_1`.

To find the exact value, go to **Events Manager**, click **Manage custom events**, select the event and look under **How to set up your custom event**.

Your options for sending event data to Cometly:

* [Send events using Cometly webhooks](https://docs.cometly.com/integrations/webhooks.md) (recommended)
* [Send events using Zapier](https://docs.cometly.com/integrations/zapier.md)
* [Send events using the Cometly API](https://docs.cometly.com/integrations/api.md)

## Test your events

After you set up your events, test them to make sure everything works.

1. Go to [**Events Manager**](https://app.cometly.com/space/events-manager) and click the **Events Log** tab.

2. Trigger a test event using your webhook or Zapier.

3. Refresh the **Events Log** page.

4. Check that the test event appears in the log.

   ![Events Log tab with Source set to Server and a box around the newest event in the list, which shows the status Processed](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/getting-started/events/06.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=b8f76521d73dba238a385f646ab72b09)

5. Open the event's details and confirm that all the information you sent is displayed correctly.

[Testing server events in Cometly](https://www.loom.com/embed/df5933e3bb2845c3b3e8c14582bbcdc1)

## Check it worked

Your test event appears in the **Events Log** with the details you sent. In **Events Manager**, an event you have configured shows the status **Active** instead of **Draft**. On the **Setup** page, step 5 is marked complete once at least one event is connected to an integration.

## Send events to the ad platforms

You can send an event to the ad platforms under its custom event name, or map the custom event to a standard event in Cometly and send it as a standard event. Standard events in Meta are predefined actions used to track and measure what people do on your website or app.

Set up the Conversion API so Cometly can send conversion data to ad platforms such as Meta, Google, TikTok, LinkedIn and Microsoft, which improves ad performance.

[Learn how to activate the Conversion API](https://docs.cometly.com/guides/conversion-api/overview.md)

## Frequently asked questions

### How many custom events can I create in Cometly?

Each space (a workspace in your Cometly account) has 50 custom events, on top of the standard events every space starts with. You name and manage them in **Events Manager** under **Manage custom events**.

### Why does my event still show as Draft in Cometly?

An event stays a draft until you connect it to its integration. In **Events Manager**, click **Configure** on the event and follow the steps on screen so it can start receiving data.

### Does the value of a custom event count toward Gross Revenue?

Only if you choose so. The **Purchase** event already counts toward Gross Revenue. For a custom event, tick **Include this event value in the "Gross Revenue" metric** in its settings, and leave it off for events whose value is only potential, such as "Deal Created".

## Next steps

* [Send conversions to ad platforms (Setup step 6)](https://docs.cometly.com/getting-started/send-conversions.md)
* [Manage custom events](https://docs.cometly.com/guides/events/custom-events.md)
* [How standard and custom events work](https://docs.cometly.com/guides/events/how-events-work.md)
* [Send event data with Cometly webhooks](https://docs.cometly.com/integrations/webhooks.md)
* [Check your tracking health](https://docs.cometly.com/getting-started/tracking-health.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.