Skip to main content

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.

  • Generate an OAuth 2.0 access token from a LinkedIn Developer app with access to your ad account.
  • The token needs the rw_conversions and r_ads scopes.
  • Copy the token and paste it into your Upstack LinkedIn destination’s API Access Token field.
What is a LinkedIn Conversions API token?LinkedIn’s Conversions API uses OAuth 2.0 access tokens to authenticate server-side event requests. The token authorizes Upstack to write conversion events (rw_conversions) and read ad account data (r_ads) on your behalf. Unlike Reddit’s non-expiring keys, LinkedIn access tokens expire (typically after 60 days) and may need to be refreshed.

​
Prerequisites

Before you start, you need:

​
Steps to generate your LinkedIn CAPI token

1

Open the LinkedIn Developer Portal

Go to the LinkedIn Developer Portal and either select an existing app or click Create app.When creating an app, associate it with the LinkedIn Company Page that owns or manages your ad account.
2

Request the required products

On the app’s Products tab, request access to the Conversions API (and Advertising API, if listed separately).
LinkedIn must approve API product access. Approval is usually quick for the Conversions API, but allow time in case verification is required.
3

Confirm the OAuth scopes

On the Auth tab, confirm the app is authorized for the following OAuth 2.0 scopes:
ScopePurpose
rw_conversionsRead/write conversion events (required)
r_adsRead ad account data for matching (required)
4

Generate an access token

Use the OAuth 2.0 flow (the Developer Portal’s token generator or your own authorization-code exchange) to generate an access token, granting the rw_conversions and r_ads scopes.
The signed-in LinkedIn user must have access to the ad account that owns the Conversion Rules. Otherwise the token will be valid but events will return a 403 permission error.
5

Copy your access token

LinkedIn displays the generated access token — a long alphanumeric string.
Copy the token immediately to a secure location. Treat it like a password and never expose it in client-side code. If lost, generate a new one.
6

Add the token to Upstack Data

Sign in to Upstack Data and open your LinkedIn destination under Event Destinations. Paste the token into the API Access Token field and save.
7

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 includes the rw_conversions and r_ads scopes.
  • Confirm the user who generated the token has access to the ad account that owns the Conversion Rules.

​
Token expiration and renewal

LinkedIn access tokens are not permanent. When a token expires:
  • The destination status changes to Unhealthy and events return a 401 error.
  • Generate a new token following the steps above and update the API Access Token field in your LinkedIn destination.
Set a reminder to rotate the token before it expires (LinkedIn access tokens typically last 60 days) so conversion forwarding is never interrupted.
Next step: How to enable LinkedIn click ID tracking