Skip to content

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) required

  • tagId (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.