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

# Freshworks CRM integration

> Set up the Freshworks CRM Cometly integration: a workflow webhook sends leads and deals to Cometly, so you can see which ad produced each one.

The Freshworks CRM Cometly integration sends what happens in your CRM to Cometly as events. An event is an action Cometly tracks, such as a new lead or a won deal. Freshworks CRM has no dedicated card in Cometly. Instead, you add a webhook action to a Freshworks workflow (automation) that posts server events to the Cometly API.

This matters because Cometly can only attribute the events it receives. Once Freshworks sends its CRM events, you can see which campaign, ad set and ad produced each lead or deal, not only the clicks that came before it.

## Before you start

You need a Cometly API token, the key Freshworks uses to sign in to the Cometly API. You need the **Administrator** or **Owner** role in the space (a workspace in your Cometly account) to see the **Cometly API** card.

1. In Cometly, click **Integrations** in the left sidebar and open the **Cometly API** card.
2. If the integration is not active yet, click **Activate Cometly API**.
3. Under **API Tokens**, enter a **Token Name** and click **Create Token**. Copy the token and keep it somewhere safe.

![Cometly Apps & Integrations page with the Webhooks & API category selected and an arrow pointing at the Cometly API card.](https://mintcdn.com/cometly/gJhojf-axy7BVk83/images/integrations/platforms/freshworks-crm/03.webp?fit=max\&auto=format\&n=gJhojf-axy7BVk83\&q=85\&s=b928967c466d3a7dd7d9d78011a2bfc3)

![Cometly API page showing the integration activated, with a box around the Token Name field containing Freshworks and an arrow pointing at the Create Token button.](https://mintcdn.com/cometly/gJhojf-axy7BVk83/images/integrations/platforms/freshworks-crm/06.webp?fit=max\&auto=format\&n=gJhojf-axy7BVk83\&q=85\&s=6aaa7de0ed83a1ac3a3bc552e2d14471)

## Set up the webhook in Freshworks

**1. Select POST as the request type**

Create a new Freshworks webhook automation and configure the trigger based on the event you want to send to Cometly. Set the request type to **POST**.

![Freshworks Request type dropdown with POST selected](https://mintcdn.com/cometly/gJhojf-axy7BVk83/images/integrations/platforms/freshworks-crm/01.webp?fit=max\&auto=format\&n=gJhojf-axy7BVk83\&q=85\&s=60a68e170a4ea92ac7239552b3614817)

**2. Enter the callback URL**

For the callback URL, enter:

```text theme={null}
https://app.cometly.com/public-api/v1/events
```

![Freshworks Enter callback URL field containing the Cometly API events URL](https://mintcdn.com/cometly/gJhojf-axy7BVk83/images/integrations/platforms/freshworks-crm/02.webp?fit=max\&auto=format\&n=gJhojf-axy7BVk83\&q=85\&s=a13c08879b50fa4ec2f7d72542705b00)

**3. Add authentication**

In Freshworks, select **Requires authentication**.

For the API key, enter `Bearer` followed by a space and your Cometly API token:

```text theme={null}
Bearer XXXXXXXXXXXXXXXX
```

Replace `XXXXXXXXXXXXXXXX` with the token you created in Cometly.

![Freshworks Webhook Settings with Requires authentication checked and a Bearer token entered](https://mintcdn.com/cometly/gJhojf-axy7BVk83/images/integrations/platforms/freshworks-crm/04.webp?fit=max\&auto=format\&n=gJhojf-axy7BVk83\&q=85\&s=9ff54e1b77692474015b99c32154d354)

**4. Build the content**

Set the encoding format to **JSON**.

The content keys must match the field names in the [Cometly API documentation](https://docs.cometly.com/api-reference/overview.md). The values are dynamic Freshworks placeholders, with one exception: `event_name` is a static value, the name of the Cometly event you are sending (for example `custom_event_3`).

> [!WARNING]
>
> An `event_name` and an `email` are required in the payload. You can add any other field listed in the Cometly API documentation.

Click **Save** to save the webhook configuration.

**5. Test the webhook**

Enroll a contact in the workflow to test it. Then, in Cometly, open **Events Manager** and click the **Events Log** tab to confirm the server event was received.

## Check it worked

In Cometly, open **Events Manager**, click the **Events Log** tab and set **Source** to **Server**. The event Freshworks sent is listed there within 60 seconds, with **SUCCESS** in the **Details** column.

## Frequently asked questions

### How long does it take for a Freshworks CRM event to show up in Cometly?

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

### Where do I find the event\_name for a custom event in Cometly?

In Cometly, click **Events Manager** in the sidebar, then click **Manage custom events**. Each custom event has a fixed `event_name` shown under its name, from `custom_event_1` to `custom_event_50`. See [Manage custom events](https://docs.cometly.com/guides/events/custom-events.md) for how to name and configure one.

### Do I need a separate Freshworks webhook for each Cometly event?

Yes. The `event_name` in the webhook content is a static value, so each webhook sends one Cometly event. To send a second event, add another webhook action in Freshworks with its own trigger and its own `event_name`.

## Next steps

* [Use the Events Log to check incoming events](https://docs.cometly.com/support/troubleshooting/general/event-log.md)
* [Create and manage Cometly API tokens](https://docs.cometly.com/integrations/api.md)
* [Manage custom events](https://docs.cometly.com/guides/events/custom-events.md)
* [Learn how events work in Cometly](https://docs.cometly.com/guides/events/how-events-work.md)
* Freshworks: [What are webhooks, and how to configure webhooks for workflows](https://crmsupport.freshworks.com/support/solutions/articles/50000002418-what-are-webhooks-how-to-configure-webhooks-for-workflows)

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.