Create a conversion destination (LinkedIn)

Create a new conversion rule on the platform. LinkedIn-only today; other platforms manage destinations in their own UIs and return 405.

For LinkedIn, the rule is created with conversionMethod=CONVERSIONS_API and (by default) auto-associated with all of the ad account's campaigns via autoAssociationType=ALL_CAMPAIGNS. Pass autoAssociationType: NONE to opt out and manage associations explicitly via the associations endpoints below.

365-day attribution windows are only valid for SUBMIT_APPLICATION, PURCHASE, ADD_TO_CART, QUALIFIED_LEAD, and LEAD rule types; the API rejects other combinations locally.

POST /v1/accounts/{accountId}/conversion-destinations

Create a new conversion rule on the platform. LinkedIn-only today; other platforms manage destinations in their own UIs and return 405.

For LinkedIn, the rule is created with conversionMethod=CONVERSIONS_API and (by default) auto-associated with all of the ad account's campaigns via autoAssociationType=ALL_CAMPAIGNS. Pass autoAssociationType: NONE to opt out and manage associations explicitly via the associations endpoints below.

365-day attribution windows are only valid for SUBMIT_APPLICATION, PURCHASE, ADD_TO_CART, QUALIFIED_LEAD, and LEAD rule types; the API rejects other combinations locally.

Parameters

• accountId (path, string) required — SocialAccount ID (linkedinads).

Request body

Content-Type: application/json

• adAccountId (string) required — Sponsored ad account ID. Numeric (e.g. "5123456") or full urn:li:sponsoredAccount:{id} URN.
• name (string) required
• type (string) required — Either a unified standard event name (e.g. "Purchase", "Lead", "AddToCart") or a LinkedIn rule type enum value (e.g. "PURCHASE", "QUALIFIED_LEAD"). The API maps standard names to LinkedIn enum values...
• attributionType (string) (enum: LAST_TOUCH_BY_CAMPAIGN, LAST_TOUCH_BY_CONVERSION)
• postClickAttributionWindowSize (integer) (enum: 1, 7, 30, 90, 365) — Default 30. 365 only allowed for LEAD, PURCHASE, ADD_TO_CART, QUALIFIED_LEAD, SUBMIT_APPLICATION rule types — the API rejects other combinations locally.
• viewThroughAttributionWindowSize (integer) (enum: 1, 7, 30, 90, 365) — Default 7. Same 365-day-window type restriction applies as postClickAttributionWindowSize.
• valueType (string) (enum: DYNAMIC, FIXED, NO_VALUE) — DYNAMIC (default) uses the per-event value from sendConversions. FIXED uses the rule's value field. NO_VALUE drops monetary value entirely.
• value (object) — Static conversion value. Used when valueType=FIXED. The currency should match the ad account's currency.
• autoAssociationType (string) (enum: ALL_CAMPAIGNS, OBJECTIVE_BASED, NONE) — Controls campaign association at rule-creation time: - ALL_CAMPAIGNS: associate the rule with every active, paused, and draft campaign in the ad account - OBJECTIVE_BASED: associate only campaigns w...

Responses

201 — Destination created

• platform (string) (enum: linkedinads)
• destination ($ref)

400 — Invalid body or LinkedIn validation failure.

401

403 — Ads access required (Ads add-on on legacy plans, included on usage-based plans), or the connected LinkedIn account lacks the rw_conversions scope (reconnect required).

404 — Account not found or not accessible.

405 — Platform does not support destination creation.

429 — LinkedIn rate limit hit. Retry with backoff.