Create a tracking tag (Meta Pixel)

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

NOT idempotent: each call creates a new pixel. Do not retry blindly on timeout. Meta only (platform metaads); other platforms return 405.

POST /v1/accounts/{accountId}/tracking-tags

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

NOT idempotent: each call creates a new pixel. Do not retry blindly on timeout. Meta only (platform metaads); other platforms return 405.

Parameters

• accountId (path, string) required — Meta ads SocialAccount id (platform metaads).

Request body

Content-Type: application/json

• adAccountId (string) required — Meta ad account id, e.g. act_123456789.
• name (string) required

Responses

201 — Tracking tag created

• platform (string) (enum: metaads)
• tag ($ref)

400 — Invalid body, invalid adAccountId, over the per-business pixel cap, or ad account not in a Business Manager.

401

403 — Ads access required (Ads add-on on legacy plans, included on usage-based plans), or the Meta token lacks ads permissions (reconnect required).

404 — Account not found or not accessible.

405 — Platform does not support creating tracking tags.