Zernio
APIFor you
Zernio
APIFor you
API Reference

Audiences

List custom audiencesGETCreate custom audiencePOSTGet audience detailsGETUpdate an audiencePUTDelete custom audienceDELETEAdd users to audiencePOSTRemove users from audienceDELETEReplace audience companiesPOST
Dashboard
OverviewPlatformsAPI ReferenceResources
Audiences

Update an audience

Renames or redescribes an audience, or replaces a saved targeting audience's rules; platform audience rules cannot change.

saved_targeting audiences accept name, description, and spec (full replacement, no merge, Zernio-only, no platform call). Platform audiences (uploaded/website/lookalike) accept name and description only, updated on the platform first and then mirrored locally; their rules are immutable, so spec returns 400 for them. Platform audience updates are Meta-only for now (other platforms return 501). Ads already created from a saved_targeting audience are unaffected, they snapshot the targeting at creation.

PlatformsMetaGoogleTikTokLinkedInPinterestX
PUT
/v1/ads/audiences/{audienceId}

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Path Parameters

audienceId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

At least one field is required.

Response Body

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.adaudiences.updateAdAudience({  path: {    audienceId: 'audience_abc123',  },  body: {    name: 'Example',    description: 'Hello, world!',    spec: {      userOs: [        'string',      ],      userDevice: [        'string',      ],      countries: [        'string',      ],    },  },});console.log(data);
{  "audience": {},  "message": "string"}
Was this page helpful?

Get audience details

Shows a custom audience's details, including its latest data from the ad platform when available. Returns the local audience record and fresh data from Meta (if available).

Delete custom audience

Removes a custom audience from its ad platform (archiving it where the platform does not delete). Removes the audience on its ad platform, then deletes the Zernio record. Meta, Google, TikTok, LinkedIn list and engagement segments, and X are deleted; Pinterest audiences and LinkedIn `website_retargeting` segments are archived, which is how those platforms remove them. `saved_targeting` audiences exist only on Zernio, so only the local record is removed. If the platform refuses, the error is returned and the Zernio record is kept, so a retry is safe. An audience the platform no longer has counts as removed. Google Ads does not allow removing lookalike lists through its API, so those return 422 `FEATURE_NOT_AVAILABLE`.

name?string
Lengthlength <= 255
description?string
spec?

Full replacement for the stored targeting spec.