Skip to content

List destinations for the Conversions API

Returns the list of pixels (Meta), conversion actions (Google), or conversion rules (LinkedIn) accessible to the connected ads account. Use the returned id as destinationId when posting to POST /v1/ads/conversions.

For Google and LinkedIn, each destination's type reflects the conversion type (PURCHASE, LEAD, SIGN_UP, etc.) — the event type is locked to the destination. For Meta, type is absent: pixels accept any event name per request.

For LinkedIn, destinations are returned across every sponsored ad account the connected token can access; the adAccountId field on each destination identifies the parent ad account and is required for subsequent CRUD calls (update, delete, associations, metrics).

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

Returns the list of pixels (Meta), conversion actions (Google), or conversion rules (LinkedIn) accessible to the connected ads account. Use the returned id as destinationId when posting to POST /v1/ads/conversions.

For Google and LinkedIn, each destination's type reflects the conversion type (PURCHASE, LEAD, SIGN_UP, etc.) — the event type is locked to the destination. For Meta, type is absent: pixels accept any event name per request.

For LinkedIn, destinations are returned across every sponsored ad account the connected token can access; the adAccountId field on each destination identifies the parent ad account and is required for subsequent CRUD calls (update, delete, associations, metrics).

Parameters

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

Responses

200 — Destinations listed

  • platform (string) (enum: metaads, googleads, linkedinads)
  • destinations (array)

400 — Account's platform is not supported by the Conversions API.

401

403 — Ads access required (Ads add-on on legacy plans, included on usage-based plans), OR (for LinkedIn) the connected account lacks the rw_conversions scope and must be reconnected.

404 — Account not found or not accessible.

429 — LinkedIn rate limit hit. Retry with backoff.