Share with an ad account
Shares a pixel with another ad account so its campaigns and audiences 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 and LinkedIn; other platforms return 501.
LinkedIn (linkedinads): grants USE_ONLY access from the ad account that created the
tag, so the target can use the tag and its conversions but cannot edit or reshare it.
adAccountId is the numeric LinkedIn ad account id. An ad account uses one Insight Tag at
a time, so a target that already has one answers 400.
TikTok: links the pixel to an advertiser through Business Center
(/bc/pixel/link/update/, adAccountId = numeric advertiser_id). Only a pixel that is an
asset of a Business Center this connection manages can be shared; otherwise the answer is
400 asking to transfer it to Business Center first.
Authorization
bearerAuth API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.
In: header
Path Parameters
Pixel id.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.trackingtags.addTrackingTagSharedAccount({ path: { accountId: 'account_abc123', tagId: 'tag_abc123', }, body: { adAccountId: 'adaccount_abc123', },});console.log(data);{ "platform": "metaads", "ok": true}List accounts it is shared with
Lists the other ad accounts a pixel is shared with. Meta (`metaads`) and LinkedIn (`linkedinads`); other platforms return 501. LinkedIn (`linkedinads`): the ad accounts this connection can see that hold access to the Insight Tag; the role (`FULL` or `USE_ONLY`) is appended to `name`. LinkedIn exposes permissions per ad account only, so accounts the connection cannot see are not listed. TikTok (`tiktokads`): the advertisers linked to the pixel in its Business Center (`/bc/pixel/link/get/`); a pixel outside Business Center answers 400.
Stop sharing with an account
Stops sharing a pixel with an ad account. `adAccountId` may be passed as a query parameter (recommended) or as a JSON body field for clients that can send DELETE bodies. Meta and LinkedIn; other platforms return 501. LinkedIn (`linkedinads`): revokes the ad account's access. Zernio answers 400 instead of revoking the last ad account that holds the tag: LinkedIn accepts that call and the tag is orphaned (verified live). TikTok: unlinks through Business Center (`/bc/pixel/link/update/` with `UNLINK`).