Create a tracking tag
Meta: creates a Meta Pixel on the given ad account (POST /act_{id}/adspixels
— name is the only input). Returns the created tag including its
install code. The pixel is owned by the Business Manager that owns the
ad account; a pixel created on a personal (non-BM) ad account ends up
with ownerBusinessId: null and can't be shared with other ad accounts.
Creating a Meta pixel does NOT install it — install the returned code
snippet on the site, or send events server-side via
POST /v1/ads/conversions. The check installed is derived from
lastFiredTime.
OpenAI Ads: creates an OpenAI pixel AND provisions a Conversions API
key for it in the same call (adAccountId is required by this
endpoint but ignored — one API key maps to exactly one ad account, so
there's nothing to select). Returns 422 (FEATURE_NOT_AVAILABLE) if
the ad account isn't enabled for pixel management; contact your OpenAI
partner representative to enable it. There is no delete API for
OpenAI pixels. If the pixel is created but the Conversions API key
provisioning then fails, the pixel is left live on OpenAI (it cannot
be cleaned up) and the error message names the surviving pixel id and
warns against retrying, since a retry would create a second, orphaned
pixel.
NOT idempotent on either platform: each call creates a new pixel (and,
for OpenAI, a new Conversions API key). Do not retry blindly on
timeout. Meta (platform metaads) and OpenAI Ads (platform
openaiads); other platforms return 405.
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
Ads SocialAccount id (platform metaads or openaiads).
Meta ad account id, e.g. act_123456789. Required by this endpoint but ignored for OpenAI Ads.
1 <= length <= 200Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.trackingtags.createTrackingTag({ path: { accountId: 'account_abc123', }, body: { adAccountId: 'adaccount_abc123', name: 'Example', },});console.log(data);{
"platform": "metaads",
"tag": {
"id": "string",
"name": "string",
"platform": "metaads",
"kind": "pixel",
"status": "active",
"code": "string",
"lastFiredTime": 0,
"isUnavailable": true,
"installed": true,
"creationTime": 0,
"ownerBusinessId": "string",
"ownerAdAccountId": "string"
}
}{
"error": "Unauthorized"
}List tracking tags GET
Returns the tracking tags (Meta Pixels, or OpenAI Ads pixels) the connected ads account can see. Pass `?adAccountId=act_...` (Meta only) to scope the list to a single ad account; omit it to list every pixel reachable by the token (the name is then suffixed with the ad account it was discovered on, for disambiguation). The list view omits `code` — call `getTrackingTag` for the install snippet and full detail (Meta only; OpenAI Ads has no get-by-id endpoint). Meta (platform `metaads`) and OpenAI Ads (platform `openaiads`); other platforms return 405. The `accountId` must be the ads SocialAccount created by the Ads add-on connect flow (Meta) or the OpenAI Ads connect flow, not a Facebook/Instagram posting account. Get your Meta `act_...` ids from `GET /v1/ads/accounts`; `adAccountId` is ignored for OpenAI Ads (one API key maps to exactly one ad account).
Get ad tracking tags GET
Unified read of the platform's native click-URL tracking params. - Meta (facebook/instagram): the creative's `url_tags` (and template_url_spec). - Google (googleads): the campaign's `trackingUrlTemplate` + `finalUrlSuffix`. Subject to the Google Ads API access-tier daily quota; bulk audits need Standard access. - LinkedIn (linkedinads): the campaign's Dynamic UTM `dynamicValueParameters` + `customValueParameters`. Returns 405 for platforms without a click-URL tracking surface (TikTok, X, Pinterest).