> For the complete documentation index, see [llms.txt](https://documentation.freshpaint.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.freshpaint.io/integrations/destinations/direct-response-ads/linkedin-ads-conversions-api/linkedin-ads-conversions-api-reference.md).

# LinkedIn Ads Conversions API Reference

## Destination Info

* Supports [Track](https://documentation.freshpaint.io/developer/freshpaint-sdk-reference#track) calls
* Supports [HIPAA mode](https://documentation.freshpaint.io/hipaa-mode)
* Supports forwarding from the [Google Tag Manager Integration](/integrations/google-tag-manager-integration.md)
* Refer to this destination as **LinkedIn Ads Conversions API** in the [Integrations object](https://documentation.freshpaint.io/reference/developer/freshpaint-sdk-reference#using-the-integrations-object)
* Connection Modes:

<table><thead><tr><th width="200.33333333333331" align="right"></th><th data-type="checkbox">Client-side</th><th data-type="checkbox">Server-side</th></tr></thead><tbody><tr><td align="right">Web</td><td>false</td><td>true</td></tr><tr><td align="right">Mobile</td><td>false</td><td>true</td></tr><tr><td align="right">Server</td><td>false</td><td>true</td></tr></tbody></table>

This is a reference document for the LinkedIn Ads destination. For information on how to set up this integration, see the [LinkedIn Ads Conversions API Quick Start Guide](/integrations/destinations/direct-response-ads/linkedin-ads-conversions-api/linkedin-ads-conversions-api-quick-start-guide.md).

### Events

When you send an event to the LinkedIn Ads Conversions API destination from Freshpaint, Freshpaint will create an event in the LinkedIn campaign manager by hitting LinkedIn's API.

## Track Events

When you send an event to the LinkedIn Ads Conversions API destination, you can track conversions from your ads based on those events.

Below are the Required, Recommended, and Optional properties which are mapped to the LinkedIn Ads Conversions API request:

<table data-header-hidden data-full-width="true"><thead><tr><th width="165"></th><th width="164"></th><th width="103"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Freshpaint property</strong></td><td><strong>LinkedIn Ads</strong><br><strong>parameter</strong></td><td><strong>Type</strong></td><td><strong>Requirement</strong></td><td><strong>Description</strong></td></tr><tr><td><code>conversion_id</code></td><td><code>conversionId</code></td><td>string</td><td>Required</td><td>A conversion ID provided by LinkedIn that allows you to trigger a specific event.<br><br>The conversion ID will have a similar format to: <code>urn:li:sponsoredAccount:5123456</code></td></tr><tr><td><code>$li_fat_id</code></td><td><code>LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID</code></td><td>string</td><td>Required [conditional]</td><td>A query parameter that connects a page view or conversion event to a specific ad, which Freshpaint captures as <code>$li_fat_id</code>.<br><br>At least one of <code>$li_fat_id</code>, <code>email</code>, <code>acxiom_id</code>, or <code>oracle_moat_id</code> are required.</td></tr><tr><td><code>email</code></td><td><code>SHA256_EMAIL</code></td><td>string</td><td>Required [conditional]</td><td>Email hashed with SHA 256 algorithm. Used to improve match rates.<br><br><strong>Use with caution. LinkedIn will be able to match hashes with original emails if the emails are recorded in their system.</strong><br><br>At least one of <code>$li_fat_id</code>, <code>email</code>, <code>acxiom_id</code>, or <code>oracle_moat_id</code> are required.</td></tr><tr><td><code>acxiom_id</code></td><td><code>ACXIOM_ID</code></td><td>string</td><td>Required [conditional]</td><td>User identifier for matching with LiveRamp identity graph. Used for view-through conversions.<br><br>At least one of <code>$li_fat_id</code>, <code>email</code>, <code>acxiom_id</code>, or <code>oracle_moat_id</code> are required.</td></tr><tr><td><code>oracle_moat_id</code></td><td><code>ORACLE_MOAT_ID</code></td><td>string</td><td>Required [conditional]</td><td>User identifier for matching with Oracle MOAT Identity. Used for view-through conversions.<br><br>At least one of <code>$li_fat_id</code>, <code>email</code>, <code>acxiom_id</code>, or <code>oracle_moat_id</code> are required.</td></tr><tr><td><code>currency_code</code></td><td><code>currencyCode</code></td><td>string</td><td>Optional</td><td>Currency code in ISO format (e.g. "USD")<br><br>Must be provided with <code>amount</code></td></tr><tr><td><code>amount</code></td><td><code>amount</code></td><td>string</td><td>Optional</td><td>Monetary amount as a decimal string (e.g. "50.0")<br><br>Must be provided with <code>currency_code</code>.</td></tr><tr><td><code>first_name</code></td><td><code>first_name</code></td><td>string</td><td>Optional</td><td>User's first name. Can improve match rates.<br><br><strong>Unmasked PII. Use with caution.</strong></td></tr><tr><td><code>last_name</code></td><td><code>last_name</code></td><td>string</td><td>Optional</td><td>User's last name. Can improve match rates.<br><br><strong>Unmasked PII. Use with caution.</strong></td></tr><tr><td><code>job_title</code></td><td><code>title</code></td><td>string</td><td>Optional</td><td>User's job title. Can improve match rates.<br><br><strong>Unmasked PII. Use with caution.</strong></td></tr><tr><td><code>company_name</code></td><td><code>company_name</code></td><td>string</td><td>Optional</td><td>User's company name. Can improve match rates.<br><br><strong>Unmasked PII. Use with caution.</strong></td></tr><tr><td><code>country_code</code></td><td><code>country_code</code></td><td>string</td><td>Optional</td><td>User's country code. Can improve match rates.<br><br><strong>Unmasked PII. Use with caution.</strong></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.freshpaint.io/integrations/destinations/direct-response-ads/linkedin-ads-conversions-api/linkedin-ads-conversions-api-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.