> ## 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 Generate a LinkedIn Conversions API Token

> Generate a LinkedIn Conversions API Direct Access Token in Campaign Manager — the simplest way to authenticate the Upstack Data LinkedIn destination for server-side conversion forwarding.

<Tip>
  * Generate a **Direct Access Token** in Campaign Manager → **Data** → **Signals Manager** → **Conversions API**.
  * Give the token the **Manage conversions** permission and access to the correct ad account.
  * Set an expiry (we recommend **1 year**), then copy the token immediately — it won't be shown again.
  * Paste it into your Upstack LinkedIn destination's **API Access Token** field.
</Tip>

<Note>
  **What is a LinkedIn Direct Access Token?**

  A **Direct Access Token** is a LinkedIn-issued access token you generate directly inside Campaign Manager — no LinkedIn Developer app or OAuth flow required. It authorizes Upstack to send conversion events to LinkedIn's Conversions API on your behalf. You control which ad accounts it covers, the permission it grants (**Manage conversions**), and how long it lasts before expiring.
</Note>

## Prerequisites

Before you start, you need:

* **Admin** or **Account Manager** access to your **LinkedIn Ads** account at [linkedin.com/campaignmanager](https://www.linkedin.com/campaignmanager/)
* Your **Partner ID** and at least one **Conversion Rule** created — see [How to create LinkedIn Conversion Rules](/guides/linkedin-ads/how-to-create-linkedin-conversion-rules)

## Steps to generate your LinkedIn CAPI token

<Steps>
  <Step title="Open Signals Manager in Campaign Manager">
    Sign in to [LinkedIn Campaign Manager](https://www.linkedin.com/campaignmanager/), select your ad account, then click **Data** → **Signals Manager** in the top navigation.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/upstackdata-afbed50d/images/linkedin/signals-manager-conversions-api.png" alt="LinkedIn Campaign Manager Signals Manager with the Conversions API tab" />
    </Frame>
  </Step>

  <Step title="Open the Conversions API tab">
    In Signals Manager, click the **Conversions API** tab. This is where you manage Direct Access Tokens for server-side event forwarding.
  </Step>

  <Step title="Generate a token">
    Click **Generate token** (or **Manage tokens** → **Generate token** if you've created tokens before).

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/upstackdata-afbed50d/images/linkedin/conversions-api-generate-token.png" alt="Generate token dialog in the LinkedIn Conversions API tab" />
    </Frame>
  </Step>

  <Step title="Select the ad accounts">
    Choose the **ad account(s)** the token should cover. The token can only send conversions for the accounts you select here.

    <Warning>
      The token must include the ad account that owns your Conversion Rules. Otherwise the token will be valid but events will return a `403` permission error.
    </Warning>
  </Step>

  <Step title="Set the permission to Manage conversions">
    Set the token permission to **Manage conversions**. This is the permission Upstack needs to write conversion events to LinkedIn.

    | Permission             | Required | Purpose                                       |
    | ---------------------- | -------- | --------------------------------------------- |
    | **Manage conversions** | Yes      | Send and manage server-side conversion events |
  </Step>

  <Step title="Set the token expiry">
    Choose how long the token stays valid. We recommend setting the expiry to **1 year** to minimize how often you need to rotate it.

    <Tip>
      Set a calendar reminder a week or two before the expiry date so you can generate a replacement token before conversion forwarding is interrupted.
    </Tip>
  </Step>

  <Step title="Copy and save the token securely">
    LinkedIn displays the generated token — a long alphanumeric string. Copy it immediately and store it somewhere secure (a password manager works well).

    <Warning>
      **The token is shown only once.** LinkedIn will not display it again after you close the dialog. If you lose it, you'll have to generate a new one. Treat it like a password and never expose it in client-side code.
    </Warning>
  </Step>

  <Step title="Add the token to Upstack Data">
    Sign in to [Upstack Data](https://app.upstackdata.com/pixel/event-destinations) and open your **LinkedIn** destination under **Event Destinations**. Paste the token into the **API Access Token** field and save.
  </Step>

  <Step title="Verify the destination is healthy">
    In the Upstack dashboard, the LinkedIn destination card should show **Healthy** with a green status indicator within 5 minutes.

    If the status shows **Unhealthy**:

    * Confirm the token was pasted in full (no truncation, no whitespace).
    * Confirm the token has the **Manage conversions** permission.
    * Confirm the token includes the ad account that owns your Conversion Rules.
  </Step>
</Steps>

## Token expiration and renewal

Direct Access Tokens expire based on the duration you set when generating them (we recommend 1 year). When a token expires:

* The destination status changes to **Unhealthy** and events return a `401` error.

To renew:

1. Go to Campaign Manager → **Data** → **Signals Manager** → **Conversions API**.
2. Generate a new token with the same ad accounts and **Manage conversions** permission.
3. Update the **API Access Token** field in your Upstack LinkedIn destination.

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