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 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.

PlatformsGoogle
POST
/v1/ads/conversions/actions

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

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.createConversionAction({  body: {    accountId: 'account_abc123',    name: 'Example',    type: 'WEBPAGE',  },});console.log(data);
{  "action": {    "id": "string",    "name": "string",    "type": "string",    "status": "string",    "category": "string",    "origin": "string",    "primaryForGoal": true,    "defaultValue": 0,    "defaultCurrency": "string",    "alwaysUseDefaultValue": true,    "countingType": "string",    "clickThroughLookbackWindowDays": 0,    "viewThroughLookbackWindowDays": 0,    "tagSnippets": [      {        "type": "string",        "pageFormat": "string",        "globalSiteTag": "string",        "eventSnippet": "string"      }    ]  }}
Was this page helpful?

List custom conversion goals

Lists the custom conversion goals in a Google Ads account, each a named set of conversion actions a campaign can bid on. Google Ads custom conversion goals (a named set of conversion actions a campaign can bid on). Removed goals are excluded. Cached like the other Google reads.

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.

accountId*string

SocialAccount ID. Must be a googleads account.

adAccountId?string

Platform ad account ID (Google customer ID, digits only). Resolved automatically when the connection has exactly one accessible customer.

customerId?string
Deprecated

Alias of adAccountId, kept for existing callers

name*string
Length1 <= length <= 100
type*"WEBPAGE"

Only WEBPAGE is supported for creation today.

Value in

  • "WEBPAGE"
defaultValue?number

Default conversion value used when an event doesn't carry its own value.

Range0 <= value
alwaysUseDefaultValue?boolean

When true, always use defaultValue and ignore any value sent with the event. Defaults to true when defaultValue is set.

category?string

conversion_action.category. Defaults to DEFAULT on create.

Value in

  • "DEFAULT"
  • "PAGE_VIEW"
  • "PURCHASE"
  • "SIGNUP"
  • "DOWNLOAD"
  • "ADD_TO_CART"
  • "BEGIN_CHECKOUT"
  • "SUBSCRIBE_PAID"
  • "PHONE_CALL_LEAD"
  • "IMPORTED_LEAD"
  • "SUBMIT_LEAD_FORM"
  • "BOOK_APPOINTMENT"
  • "REQUEST_QUOTE"
  • "GET_DIRECTIONS"
  • "OUTBOUND_CLICK"
  • "CONTACT"
  • "ENGAGEMENT"
  • "STORE_VISIT"
  • "STORE_SALE"
  • "QUALIFIED_LEAD"
  • "CONVERTED_LEAD"
countingType?string

ONE_PER_CLICK counts one conversion per ad click (leads); MANY_PER_CLICK counts every one (purchases).

Value in

  • "ONE_PER_CLICK"
  • "MANY_PER_CLICK"
defaultCurrency?string

ISO 4217 currency of defaultValue (value_settings.default_currency_code).

Match^[A-Z]{3}$
clickThroughLookbackWindowDays?integer

Days after an ad click a conversion still counts.

Range1 <= value <= 90
viewThroughLookbackWindowDays?integer

Days after an ad view a view-through conversion still counts.

Range1 <= value <= 30
primaryForGoal?boolean

true = primary (counts toward bidding when its goal is biddable), false = secondary.