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

# Configure the LinkedIn Conversion API

> Set up the LinkedIn Conversion API in Cometly: create a conversion in Campaign Manager and map it to a Cometly event so LinkedIn gets your conversions.

The LinkedIn Conversion API (LinkedIn calls it the Conversions API) is a server-to-server connection that lets Cometly send the conversions it tracks straight to your LinkedIn ad account. You create a conversion in LinkedIn Campaign Manager, then map it to a Cometly event (an action Cometly tracks, such as a lead or a purchase).

This matters because LinkedIn can only optimize and report on the conversions it knows about. Once the mapping is saved, the leads and sales Cometly ties back to your ads are recorded on your LinkedIn campaigns, so LinkedIn's reporting and optimization work from more complete data.

## How it works and why it helps

Sending Cometly's conversion data back to the LinkedIn ads platform gives LinkedIn more complete data to report on and optimize with.

The video below comes from [Cometly 101: How it works](https://docs.cometly.com/getting-started/how-cometly-works.md).

[Feeding the ad platform's AI with accurate data](https://www.loom.com/embed/1b4fcb623b17409ba6a2547ec21330e1)

## Before you start

* Connect your LinkedIn ad account to the space. See [Connect your ad platforms](https://docs.cometly.com/getting-started/connect-ad-platforms.md).
* The person who connects LinkedIn needs the right roles on the ad account and on the company page. See [Required permissions](#required-permissions) below.
* Make sure the events you want to send are tracking accurately in Cometly.

## Step 1: Create a Conversions API conversion in LinkedIn

Do this in LinkedIn Campaign Manager.

1. Click **Analyze**, then **Conversion tracking**.

   ![LinkedIn Campaign Manager side menu with arrows on Analyze and Conversion tracking](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/conversion-api/linkedin/01.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=9f337dbed6ffc0d49762e7b1ffe94abd)

2. Click **Create conversion**, then **Conversions API**.

   ![LinkedIn Conversion tracking page with the Create conversion menu open and Conversions API highlighted](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/conversion-api/linkedin/02.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=e8b5a6761c8a8eec7405297070a05cfb)

3. Fill in the conversion settings. We recommend:

   * **Define the key conversion behavior you want to track**: select an option in the "Lead" or "Sale" category.
   * **Select the timeframe for when the conversion can be counted**: select 90 days for both clicks and views.
   * **Select the attribution model to specify how each ad interaction is credited**: select "Last Touch - Each Campaign".

4. Select **Direct API** as the integration.

   ![LinkedIn Create conversions API conversion screen, Sources step, with an arrow on Direct API](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/conversion-api/linkedin/03.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=dfe950eeeaa257440a57a5d2ab7def52)

5. Select the campaigns you want to track with this conversion and click **Create**.

   ![LinkedIn Create conversions API conversion screen, Campaigns step, with one campaign ticked](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/conversion-api/linkedin/04.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=98a916d1cc950e1c147502876be276da)

## Step 2: Map the LinkedIn conversion to a Cometly event

1. In Cometly, click **Events Manager** in the sidebar, open the **Conversion API** tab, and click the **LinkedIn** row to expand it.

   ![Cometly Conversion API tab in Events Manager listing the ad platform rows, with an arrow pointing at the LinkedIn row](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/conversion-api/linkedin/05.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=139d24b7d7e0e0917052b2e952b2c074)

2. Under **Manage data sharing**, select **Turn on data sharing**. The change is saved straight away.

3. Under **LinkedIn ad account**, select the account that holds the conversion you created. Cometly lists that account's enabled Conversions API conversions under **LinkedIn conversions**.

4. For each LinkedIn conversion you want to use, pick the event to send under **Cometly events**, then choose a **Rule**:

   * **Send all events**: sends every occurrence of the event to this LinkedIn account, whether or not it is attributed to one of its ads.
   * **Only send attributed events**: sends the event only when Cometly attributed it to this LinkedIn account.

5. Click **Save**.

   ![Expanded LinkedIn row with Turn on data sharing selected, an ad account chosen and LinkedIn conversions mapped to Cometly events with a Rule, with arrows on the first mapped Cometly events dropdown and the Save button](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/guides/conversion-api/linkedin/06.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=f40a1ad5b16495b1e993750ca9b08a93)

From now on, whenever Cometly tracks a mapped event, it sends the data to LinkedIn and records it on the LinkedIn conversion you selected.

## Check it worked

On the **Conversion API** tab, the **LinkedIn** row now shows an **Active** badge. When you expand the row and select the same account under **LinkedIn ad account**, each LinkedIn conversion shows the Cometly event and **Rule** you saved.

After the next mapped event is tracked, look for it on the conversion in LinkedIn Campaign Manager. Cometly sends it about 15 minutes after the event, and LinkedIn can take up to 48 hours to process it.

## Required permissions

The person who connects LinkedIn to Cometly must have the correct permissions on both the LinkedIn ad account and the LinkedIn company page. If either is missing, the connection fails or conversions do not sync.

### Ad account role

The connecting user needs one of these roles on the LinkedIn Ads account:

* Account Manager
* Campaign Manager
* Creative Manager
* Billing Admin

**Viewer access will not work.** LinkedIn blocks Viewer-level users from the Conversions API entirely.

To check your role, go to LinkedIn Campaign Manager > Account settings > Manage access.

### Page admin role

The connecting user also needs one of these roles on the LinkedIn company page linked to the ad account:

* Super Admin
* Content Admin

This is the most commonly missed requirement. To check your role, go to your company page > Settings > Manage admins.

## Troubleshooting

**No ad accounts show up during setup**

The user who connected LinkedIn probably only has Viewer access. Have an Account Manager or Campaign Manager connect instead.

**The connection works but no conversions appear**

* Cometly sends each conversion about 15 minutes after the event is tracked. Allow up to 48 hours for LinkedIn to process it.
* Confirm the conversion is associated with the correct campaigns in LinkedIn Campaign Manager.
* Confirm the contact has an email address. Cometly identifies the person to LinkedIn by a hashed email.
* Confirm the event is mapped to the LinkedIn conversion, and check its **Rule**: with **Only send attributed events**, conversions that Cometly did not attribute to this LinkedIn account are not sent.

**Permissions changed after connecting**

If the connecting user's role is downgraded to Viewer, or their page admin access is removed, the sync may break. Disconnect and reconnect with a user who has the required permissions.

## Frequently asked questions

### Why is my LinkedIn conversion not showing in Cometly?

Cometly only lists conversions that are enabled in LinkedIn and were created with the **Conversions API** method. A conversion created another way, for example with the Insight Tag, does not appear. Create a new conversion as described in Step 1, then select the account again under **LinkedIn ad account** to reload the list.

### What conversion value does Cometly send to LinkedIn?

If the Cometly event has an amount, Cometly sends that amount in your space's currency (a space is one workspace in Cometly, usually one business or website). If the event has no amount, Cometly sends the value set on the LinkedIn conversion itself.

### Can I use the LinkedIn Conversion API with more than one ad account?

Yes. Each LinkedIn ad account has its own mapping. Select each account in turn under **LinkedIn ad account**, map its conversions to Cometly events, and click **Save** for each one.

## Next steps

* [Exclude an event from the Conversion API](https://docs.cometly.com/guides/conversion-api/exclude-an-event.md)
* [Set up the Conversion API for another ad platform](https://docs.cometly.com/guides/conversion-api/overview.md)
* [Connect and manage LinkedIn Ads in Cometly](https://docs.cometly.com/integrations/ad-platforms/linkedin.md)
* [Track LinkedIn Lead Gen Forms](https://docs.cometly.com/integrations/forms/linkedin-lead-forms.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.