Assign a user to a tag
Gives a user of the owning business access to the tag. Assigning an already assigned user replaces their task set.
Meta: tasks are AA_ANALYZE, ADVERTISE, ANALYZE, EDIT, UPLOAD; userId is the
business-scoped id from GET /v1/ads/businesses/users. A pixel on a personal ad account
answers 400. Needs business_management like the list.
Authorization
bearerAuth API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.
In: header
Path Parameters
Tag id (TrackingTag.id).
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
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.assignTrackingTagUser({ path: { accountId: 'account_abc123', tagId: 'tag_abc123', }, body: { userId: 'user_abc123', tasks: [ 'string', ], },});console.log(data);{ "platform": "string", "userId": "string", "tasks": [ "string" ]}Set ad tracking tags
Unified update. Send only the fields for the ad's platform: - Meta: `urlTags` (array of {key,value}). Meta creatives are immutable, so this rebuilds the creative and repoints the ad. By DEFAULT we PRESERVE the existing creative verbatim (re-post its object_story_spec + the new url_tags, reusing the image), so you send `urlTags` ALONE, with no need to read back headline/body/CTA. `creative` (headline, body, callToAction, linkUrl, imageUrl) is OPTIONAL and only needed to rebuild explicitly, or for SHARE / page-post / dark / asset_feed creatives whose object_story_spec Meta strips (those return 422 asking for `creative`). - Google: `trackingUrlTemplate` and/or `finalUrlSuffix` (full template strings; account quota applies). - LinkedIn: `dynamicValueParameters` and/or `customValueParameters` (campaign-level Dynamic UTM).
List partner businesses of a tag
Other businesses the tag is shared with. Read-only. Platforms without partner sharing answer 501. Meta: the pixel's shared agencies. Sharing a pixel with a new partner is not available: `/{pixel}/agencies` answers "(#3) Application does not have the capability to make this API call" for our app.