Add users to audience

Upload user data to a customer_list audience. Data is SHA256-hashed server-side before sending to the platform. Email is used on every platform; phone is used on Meta only (other platforms ignore it). On TikTok and Pinterest, the first upload also provisions the audience (deferred create). LinkedIn uploads are full-replace. Max 10,000 users per request.

PlatformsMetaGoogleTikTokLinkedInPinterestX

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Path Parameters

audienceIdstring

Request Body

users

Itemsitems <= 10000

Response Body

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.adaudiences.addUsersToAdAudience({  path: {    audienceId: 'audience_abc123',  },  body: {    users: [      {        email: 'user@example.com',        phone: 'string',      },    ],  },});console.log(data);

{
  "message": "string",
  "numReceived": 0,
  "numInvalid": 0
}

Empty

{
  "error": "Unauthorized"
}

Empty

{
  "error": "Not found"
}

Empty

PlatformsMetaGoogleTikTokLinkedInPinterestX

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Path Parameters

audienceIdstring

Request Body

users

Itemsitems <= 10000

Response Body

application/json

import Zernio from '@zernio/node';

const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });

const { data } = await zernio.adaudiences.addUsersToAdAudience({
  path: {
    audienceId: 'audience_abc123',
  },
  body: {
    users: [
      {
        email: 'user@example.com',
        phone: 'string',
      },
    ],
  },
});
console.log(data);

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.adaudiences.addUsersToAdAudience({  path: {    audienceId: 'audience_abc123',  },  body: {    users: [      {        email: 'user@example.com',        phone: 'string',      },    ],  },});console.log(data);

{
  "message": "string",
  "numReceived": 0,
  "numInvalid": 0
}

Empty

{
  "error": "Unauthorized"
}

Empty

{
  "error": "Not found"
}

Empty

Add users to audience

200application/json

400

401application/json

403

404application/json

422

Add users to audience

200application/json

400

401application/json

403

404application/json

422

application/json

application/json

application/json

application/json

application/json

application/json