Appearance
Update a tracking tag (Meta Pixel)
Partial-update a pixel. Whitelisted fields: name (rename), enableAutomaticMatching, automaticMatchingFields, firstPartyCookieStatus, dataUseSetting. At least one is required. Returns the re-fetched canonical tag. Meta only (platform metaads); other platforms return 405.
There is no DELETE — Meta has no API to delete a pixel. To stop using one, unshare it from your ad accounts (DELETE .../tracking-tags/{tagId}/shared-accounts) or disable it in Events Manager.
PATCH /v1/accounts/{accountId}/tracking-tags/{tagId}
Partial-update a pixel. Whitelisted fields: name (rename), enableAutomaticMatching, automaticMatchingFields, firstPartyCookieStatus, dataUseSetting. At least one is required. Returns the re-fetched canonical tag. Meta only (platform metaads); other platforms return 405.
There is no DELETE — Meta has no API to delete a pixel. To stop using one, unshare it from your ad accounts (DELETE .../tracking-tags/{tagId}/shared-accounts) or disable it in Events Manager.
Parameters
accountId(path, string) requiredtagId(path, string) required — Pixel id.
Request body
Content-Type: application/json
name(string)enableAutomaticMatching(boolean) — Meta Advanced Matching toggle (enable_automatic_matching).automaticMatchingFields(array) — Which user fields Advanced Matching may collect. Meta's terse codes: em=email, ph=phone, fn=first name, ln=last name, ge=gender, db=date of birth, ct=city, st=state, zp=zip.firstPartyCookieStatus(string) (enum: empty, first_party_cookie_disabled, first_party_cookie_enabled)dataUseSetting(string) (enum: advertising_and_analytics, analytics_only, empty)
Responses
200 — Tracking tag updated (re-fetched canonical state)
platform(string) (enum: metaads)tag($ref)
400 — Invalid body (e.g. no fields supplied) or Meta validation failure.
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 or tracking tag not found.
405 — Platform does not support updating tracking tags.