> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upstackdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Configure LinkedIn Destination in Upstack Data

> Configure the LinkedIn Ads destination in Upstack Data — enter your Partner ID, API Access Token, and Conversion Rule IDs to enable server-side conversion forwarding.

<Tip>
  * Navigate to **Event Destinations** in your Upstack dashboard.
  * Add a **LinkedIn Ads** destination with your **Partner ID**, **API Access Token**, and **Conversion Rule IDs**.
  * Enable **Enhanced Matching** to send hashed user data for improved attribution.
  * Verify the destination shows **Healthy** status after saving.
</Tip>

## Prerequisites

Before you start, you need:

* An active Upstack Data account ([sign up](https://app.upstackdata.com))
* Your **LinkedIn Partner ID** — see [How to find your LinkedIn Partner ID](/guides/linkedin-ads/how-to-find-linkedin-partner-id)
* A **Conversions API access token** — see [How to generate a LinkedIn Conversions API token](/guides/linkedin-ads/how-to-generate-linkedin-conversion-api-token)
* **Conversion Rule IDs** for each event type — see [How to create LinkedIn Conversion Rules](/guides/linkedin-ads/how-to-create-linkedin-conversion-rules)

## Steps to configure the LinkedIn destination

<Steps>
  <Step title="Open Event Destinations in Upstack">
    Sign in to your [Upstack Data dashboard](https://app.upstackdata.com) and navigate to **Event Destinations** from the left sidebar.
  </Step>

  <Step title="Add a new destination">
    Click **+ Add Destination** and select **LinkedIn Ads** from the destination catalog.
  </Step>

  <Step title="Enter your Partner ID">
    Paste your **LinkedIn Partner ID** into the **Partner ID** field.

    <Tip>
      Your Partner ID is a numeric value (e.g., `123456`) found in LinkedIn Campaign Manager → Data → Signals Manager. Ensure there are no extra spaces.
    </Tip>
  </Step>

  <Step title="Enable the Conversions API">
    Toggle **Enable LinkedIn Conversions API** to send server-side events in addition to the Insight Tag.

    <Note>
      When enabled, Upstack sends events directly to LinkedIn's Conversions API, bypassing browser restrictions. We recommend keeping this enabled for maximum match quality.
    </Note>
  </Step>

  <Step title="Enter your API Access Token">
    Paste your **Conversions API access token** into the **API Access Token** field.

    This is the **Direct Access Token** you generate in Campaign Manager with the **Manage conversions** permission. If you haven't generated one yet, see [How to generate a LinkedIn Conversions API token](/guides/linkedin-ads/how-to-generate-linkedin-conversion-api-token).
  </Step>

  <Step title="Map Conversion Rule IDs">
    Enter the **Conversion Rule ID** for each event type you want to track:

    | Field                              | Description                                         |
    | ---------------------------------- | --------------------------------------------------- |
    | **Purchase Conversion Rule ID**    | The numeric ID for your Purchase conversion rule    |
    | **Add to Cart Conversion Rule ID** | The numeric ID for your Add to Cart conversion rule |
    | **Lead Conversion Rule ID**        | The numeric ID for your Lead conversion rule        |
    | **Sign Up Conversion Rule ID**     | The numeric ID for your Sign Up conversion rule     |

    <Warning>
      Each Conversion Rule ID must be a numeric value (e.g., `12345678`). If you haven't created conversion rules yet, see [How to create LinkedIn Conversion Rules](/guides/linkedin-ads/how-to-create-linkedin-conversion-rules).
    </Warning>

    **You don't need to fill in all fields.** Only configure the events you want to track. Upstack will skip events that don't have a corresponding Conversion Rule ID.
  </Step>

  <Step title="Enable Enhanced Matching (recommended)">
    Toggle **Enable Enhanced Matching** to send hashed user data (email) to LinkedIn for improved ad attribution.

    <Note>
      Enhanced Matching sends SHA-256 hashed email addresses to LinkedIn. The data is hashed before it leaves your Upstack account.
    </Note>
  </Step>

  <Step title="Save the configuration">
    Click **Create Configuration** (or **Save Changes** if editing) to save the destination.
  </Step>

  <Step title="Verify the destination is healthy">
    In the Upstack dashboard, navigate to **Event Destinations**. Your LinkedIn destination should display **Healthy** with a green status indicator within 5 minutes.

    If the status shows **Unhealthy**, double-check:

    * Partner ID is correct (numeric, no spaces)
    * API Access Token is valid and hasn't expired
    * Conversion Rule IDs are correct (numeric values only)
    * Your LinkedIn user has the required permissions
  </Step>
</Steps>

## Configuration fields reference

| Field                               | Required    | Description                                     |
| ----------------------------------- | ----------- | ----------------------------------------------- |
| **Partner ID**                      | Yes         | Your LinkedIn Partner ID from Campaign Manager  |
| **Enable LinkedIn Conversions API** | No          | Send events server-side via the Conversions API |
| **API Access Token**                | Conditional | Required when Conversions API is enabled        |
| **Purchase Conversion Rule ID**     | No          | Conversion Rule ID for Purchase events          |
| **Add to Cart Conversion Rule ID**  | No          | Conversion Rule ID for Add to Cart events       |
| **Lead Conversion Rule ID**         | No          | Conversion Rule ID for Lead events              |
| **Sign Up Conversion Rule ID**      | No          | Conversion Rule ID for Sign Up events           |
| **Enable Enhanced Matching**        | No          | Send hashed email for improved attribution      |

<Note>
  **Next step:** [How to enable LinkedIn click ID tracking](/guides/linkedin-ads/how-to-enable-linkedin-click-id-tracking)
</Note>