Zernio
APIFor you
Zernio
APIFor you
API Reference

Conversions API

List account conversion goalsGETList conversion actionsGETList associated campaignsGETList conversion destinationsGETList custom conversion goalsGETCreate website conversion actionPOSTCreate a conversion destinationPOSTCreate a custom conversion goalPOSTGet a conversion destinationGETGet attribution metricsGETGet Event Match QualityGETUpdate account conversion goalsPATCHUpdate a conversion action's settingsPATCHUpdate a conversion destinationPATCHUpdate a custom conversion goalPATCHDelete a conversion destinationDELETEAssociate campaignsPOSTAdjust uploaded conversionsPOSTRemove associated campaignsDELETERemove a custom conversion goalDELETESend conversion eventsPOST
Dashboard
OverviewPlatformsAPI ReferenceResources
Conversions API

Create a conversion destination

Creates a new place to send conversion events: a Google Ads conversion action or a LinkedIn conversion rule.

Supported for LinkedIn (conversion rule) and Google Ads (conversion action). Meta and OpenAI Ads pixels are created via their own tracking-tags flow instead (POST /v1/accounts/{accountId}/tracking-tags); this endpoint returns 405 for both, and for Reddit (create Reddit pixels in Reddit Ads Manager).

LinkedIn: creation is NOT idempotent. A retry creates a second destination. Deduplicate before retrying.

Google Ads: calling with a name that already exists reuses the existing conversion action transparently (the response is identical to a fresh create). Calling with the same name but a different category returns a typed IDEMPOTENCY_CONFLICT (409) rather than silently returning the mismatched action.

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.

Google Ads: the conversion action is created with type=UPLOAD_CLICKS (required for API-uploaded offline conversions, immutable after creation). The type field carries the Google ConversionActionCategory enum value, e.g. PURCHASE, SUBSCRIBE_PAID, SIGNUP, IMPORTED_LEAD, BOOK_APPOINTMENT. Unified standard event names (e.g. Purchase, Subscribe, CompleteRegistration, Lead, Schedule) are resolved to their Google category equivalents automatically. The action defaults to secondary (non-primary) to avoid immediately steering Smart Bidding; pass primaryForGoal: true to opt in.

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

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Path Parameters

accountId*string

SocialAccount ID (linkedinads or googleads).

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.conversions.createConversionDestination({  path: {    accountId: 'account_abc123',  },  body: {    adAccountId: 'adaccount_abc123',    name: 'Example',    type: 'string',  },});console.log(data);
{  "platform": "linkedinads",  "destination": {    "id": "string",    "name": "string",    "type": "string",    "status": "active",    "adAccountId": "string"  }}
Was this page helpful?

Create website conversion action

Creates a Google Ads website conversion action and returns the tag snippets to install on your site. Creates a `WEBPAGE` conversion action (category `DEFAULT`) and returns it with its tag snippets, read back after creation since Google never returns them on the create response itself. Invalidates the cached list `GET` on this resource would otherwise keep serving. Google-only; other platforms return `501`. Requires the Ads add-on.

Create a custom conversion goal

Creates a Google Ads custom conversion goal from a set of conversion actions, so a campaign can bid on just those. Creates a custom conversion goal from conversion action ids. Point a campaign at it with `PATCH /v1/ads/campaigns/{campaignId}/conversion-goals`.

adAccountId*string

Ad account ID. For LinkedIn: numeric (e.g. "5123456") or full urn:li:sponsoredAccount:{id} URN. For Google: numeric customer ID (e.g. "1234567890") or customers/{id} form.

name*string
Lengthlength <= 255
type*string

Conversion type. For LinkedIn: a unified standard event name (e.g. "Purchase", "Lead", "AddToCart") or a LinkedIn rule type enum (e.g. "PURCHASE", "QUALIFIED_LEAD"). For Google: a unified standard event name (Purchase, Subscribe, CompleteRegistration, Lead, Schedule) or a Google ConversionActionCategory enum value directly (e.g. "PURCHASE", "SUBSCRIBE_PAID", "SIGNUP", "IMPORTED_LEAD", "BOOK_APPOINTMENT"). Unknown values pass through to the platform.

attributionType?string

LinkedIn only.

Value in

  • "LAST_TOUCH_BY_CAMPAIGN"
  • "LAST_TOUCH_BY_CONVERSION"
postClickAttributionWindowSize?integer

LinkedIn only. Default 30. 365 only allowed for LEAD, PURCHASE, ADD_TO_CART, QUALIFIED_LEAD, SUBMIT_APPLICATION rule types; the API rejects other combinations locally.

Value in

  • 1
  • 7
  • 30
  • 90
  • 365
viewThroughAttributionWindowSize?integer

LinkedIn only. Default 7. Same 365-day-window type restriction applies as postClickAttributionWindowSize.

Value in

  • 1
  • 7
  • 30
  • 90
  • 365
valueType?string

LinkedIn only. DYNAMIC (default) uses the per-event value from sendConversions. FIXED uses the rule's value field. NO_VALUE drops monetary value entirely.

Value in

  • "DYNAMIC"
  • "FIXED"
  • "NO_VALUE"
value?

LinkedIn only. Static conversion value. Used when valueType=FIXED. The currency should match the ad account's currency.

autoAssociationType?string

LinkedIn only. 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 whose objective matches the rule's type
  • NONE: don't auto-associate. Manage associations via the /associations endpoints below. Note: auto-association runs once at create time; new campaigns added after the rule still need explicit association.
Default"ALL_CAMPAIGNS"

Value in

  • "ALL_CAMPAIGNS"
  • "OBJECTIVE_BASED"
  • "NONE"
countingType?string

Google Ads only. Whether to count multiple conversions from the same click (MANY_PER_CLICK) or at most one (ONE_PER_CLICK). Defaults to MANY_PER_CLICK if omitted.

Value in

  • "MANY_PER_CLICK"
  • "ONE_PER_CLICK"
primaryForGoal?boolean

Google Ads only. When true, the conversion action is marked as primary and immediately influences Smart Bidding. Defaults to false (secondary, record-only) to avoid unintentionally steering the customer's campaigns on creation.