ad audiences
Add users to a customer list audience
Upload user data (emails and/or phone numbers) to a customer_list audience. Data is SHA256-hashed server-side before sending to Meta. Max 10,000 users per request.
AuthorizationBearer <token>
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
audienceIdstring
users
Items
items <= 10000Response Body
application/json
application/json
application/json
curl -X POST "https://zernio.com/api/v1/ads/audiences/string/users" \ -H "Content-Type: application/json" \ -d '{ "users": [ {} ] }'{
"message": "string",
"numReceived": 0,
"numInvalid": 0
}Empty
{
"error": "Unauthorized"
}Empty
{
"error": "Not found"
}Empty
Delete a custom audience DELETE
Deletes the audience from both Meta and the local database.
List campaigns with aggregate metrics GET
Returns campaigns as virtual aggregations over ad documents grouped by platform campaign ID. Metrics (spend, impressions, clicks, etc.) are summed across all ads in each campaign. Campaign status is derived from child ad statuses (active > pending_review > paused > error > completed > cancelled > rejected).