Create custom audience

Create a customer list, website retargeting, or lookalike audience on Meta (Facebook/Instagram).

Authorization

AuthorizationBearer <token>

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

In: header

Request Body

accountIdstring

adAccountIdstring

Must start with act_

namestring

Lengthlength <= 255

description?string

typestring

Value in"customer_list" | "website" | "lookalike"

pixelId?string

Required for website audiences

retentionDays?integer

Required for website audiences

Range1 <= value <= 180

sourceAudienceId?string

Required for lookalike audiences

country?string

2-letter code, required for lookalike audiences

ratio?number

Required for lookalike audiences

Range0.01 <= value <= 0.2

rule?object

Pixel event rule for website audiences (optional)

customerFileSource?string

Data source declaration for GDPR compliance (customer_list only)

Response Body

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.adaudiences.createAdAudience({  body: {    accountId: 'account_abc123',    adAccountId: 'adaccount_abc123',    name: 'Example',    type: 'customer_list',  },});console.log(data);

{
  "audience": {},
  "message": "string"
}

Empty

{
  "error": "Unauthorized"
}

Empty

Authorization

AuthorizationBearer <token>

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

In: header

Request Body

accountIdstring

adAccountIdstring

Must start with act_

namestring

Lengthlength <= 255

description?string

typestring

Value in"customer_list" | "website" | "lookalike"

pixelId?string

Required for website audiences

retentionDays?integer

Required for website audiences

Range1 <= value <= 180

sourceAudienceId?string

Required for lookalike audiences

country?string

2-letter code, required for lookalike audiences

ratio?number

Required for lookalike audiences

Range0.01 <= value <= 0.2

rule?object

Pixel event rule for website audiences (optional)

customerFileSource?string

Data source declaration for GDPR compliance (customer_list only)

Response Body

application/json

import Zernio from '@zernio/node';

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

const { data } = await zernio.adaudiences.createAdAudience({
  body: {
    accountId: 'account_abc123',
    adAccountId: 'adaccount_abc123',
    name: 'Example',
    type: 'customer_list',
  },
});
console.log(data);

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.adaudiences.createAdAudience({  body: {    accountId: 'account_abc123',    adAccountId: 'adaccount_abc123',    name: 'Example',    type: 'customer_list',  },});console.log(data);

{
  "audience": {},
  "message": "string"
}

Empty

{
  "error": "Unauthorized"
}

Empty

Create custom audience

Authorization

Request Body

Response Body

201application/json

400

401application/json

403

Create custom audience

Authorization

Request Body

Response Body

201application/json

400

401application/json

403

application/json

application/json

application/json

application/json