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.
Prerequisites
Before you start, you need:- An active Upstack Data account (sign up)
- Your LinkedIn Partner ID — see How to find your LinkedIn Partner ID
- A Conversions API access token — see How to generate a LinkedIn Conversions API token
- Conversion Rule IDs for each event type — see How to create LinkedIn Conversion Rules
Steps to configure the LinkedIn destination
Open Event Destinations in Upstack
Sign in to your Upstack Data dashboard and navigate to Event Destinations from the left sidebar.
Enable the Conversions API
Toggle Enable LinkedIn Conversions API to send server-side events in addition to the Insight Tag.
When enabled, Upstack sends events directly to LinkedIn’s Conversions API, bypassing browser restrictions. We recommend keeping this enabled for maximum match quality.
Enter your API Access Token
Paste your Conversions API access token into the API Access Token field.This token must have
rw_conversions and r_ads scopes. If you haven’t generated one yet, see How to generate a LinkedIn Conversions API token.Map Conversion Rule IDs
Enter the Conversion Rule ID for each event type you want to track:
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.
| 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 |
Enable Enhanced Matching (recommended)
Toggle Enable Enhanced Matching to send hashed user data (email) to LinkedIn for improved ad attribution.
Enhanced Matching sends SHA-256 hashed email addresses to LinkedIn. The data is hashed before it leaves your Upstack account.
Save the configuration
Click Create Configuration (or Save Changes if editing) to save the destination.
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
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 |
Next step: How to enable LinkedIn click ID tracking