Share a tracking tag with an ad account

Shares the pixel with another ad account so campaigns/audiences in that account can use it. Requires that you administer both the pixel's owning Business Manager and the target ad account; a pixel on a personal (non-BM) ad account can't be shared (Meta will reject the call). Meta only (platform metaads); other platforms return 405.

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

Shares the pixel with another ad account so campaigns/audiences in that account can use it. Requires that you administer both the pixel's owning Business Manager and the target ad account; a pixel on a personal (non-BM) ad account can't be shared (Meta will reject the call). Meta only (platform metaads); other platforms return 405.

Parameters

• accountId (path, string) required

• tagId (path, string) required — Pixel id.

Request body

Content-Type: application/json

• adAccountId (string) required — Ad account to share with, e.g. act_123456789.

Responses

201 — Tracking tag shared with the ad account

• platform (string) (enum: metaads)
• ok (boolean)

400 — Invalid body / adAccountId, or Meta rejected the share (e.g. personal ad account).

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