Skip to content
adscapi

LinkedIn CAPI Payload Preview

The server-side request adscapi builds when you track() a purchase and LinkedIn is configured. Secrets and hashed values show as placeholders.

Request

POST
Endpoint
https://api.linkedin.com/rest/conversionEvents
Headers
Authorization: Bearer {LINKEDIN_CAPI_TOKEN}
Content-Type: application/json
Linkedin-Version: 202401
X-Restli-Protocol-Version: 2.0.0
Body (purchase example)
{
  "conversion": "urn:lla:llaPartnerConversion:{LINKEDIN_CONVERSION_ID}",
  "conversionHappenedAt": 1739452800000,
  "user": {
    "userIds": [
      {
        "idType": "SHA256_EMAIL",
        "idValue": "<sha256(normalized-email)>"
      }
    ]
  },
  "eventId": "order_1001"
}

Verified against the library dispatcher (src/dispatchers/linkedin.ts). See the LinkedIn setup guide for where to get each secret.

Required secrets

LINKEDIN_CAPI_TOKENLINKEDIN_CONVERSION_ID

LinkedIn activates when every secret is present. One missing key and the platform no-ops — the rest still receive the event.

Event-name mapping

Canonical eventLinkedIn receives
page_viewKEY_PAGE_VIEW
leadLEAD
signup_startsignup_start (custom event passthrough)
signupSIGN_UP
checkout_createdSTART_CHECKOUT
purchasePURCHASE
reply_generatedreply_generated (custom event passthrough)
upgrade_clickedupgrade_clicked (custom event passthrough)

Good to know

  • No value or currency is sent — the conversionEvents payload has no fields for them.
  • The payload carries no event-name field; the event type is fixed on the conversion rule the URN points at.
  • conversionHappenedAt is epoch milliseconds; eventId is the transaction id.
  • The dispatcher prefixes a bare LINKEDIN_CONVERSION_ID with urn:lla:llaPartnerConversion: unless it already starts with urn:.

Frequently Asked Questions

Related Tools

Discover more free tools to fix your tracking

Event Payload Playground

Pick a canonical conversion event, fill the fields, and see the exact JSON payload adscapi builds — before you write a line of code.

Try it now

PII Hash Previewer

Type a raw email or phone number and see the normalized value plus its SHA-256 hash — the exact rules adscapi applies per platform. Nothing leaves the browser.

Try it now

Platform Coverage Explorer

Search all 26 ad platforms adscapi dispatches to — support level, required secrets, and setup docs, always in sync with the library registry.

Try it now

Ready to track LinkedIn conversions server-side?

adscapi is free and open source. Set your platform tokens, call track() once, and every configured Conversions API receives the event — hashed the way each platform expects.

Get startednpm install adscapi