API referenceAds

POST /ads/audiences/{id}/users

Add users to a custom audience: emails or phones, normalized and SHA-256 hashed by Postgale (raw values never reach Meta); up to 10000 per call

POST
/ads/audiences/{id}/users

Authorization

BearerAuth
headerAuthorizationBearer <token>

API key sk_...

Path Parameters

id*string

Custom audience id

Request Body

application/json
  1. body
accountId*string
emails?array<string>
phones?array<string>

Response Body

{audienceId, received, schema}

application/json
  1. response
audienceId?string
received?integer
schema?string
Example Request
curl -X POST 'https://example.com/api/v1/ads/audiences/string/users' \  -H 'Content-Type: application/json' \  -d '{  "accountId": "string"}'
Example Response
{  "audienceId": "string",  "received": 0,  "schema": "string"}

DELETE /ads/audiences/{id} DELETE

Delete a custom audience

GET /ads/insights GET

Ads insights (impressions, reach, clicks, spend, cpc, cpm, ctr, actions) of an ad account, campaign, ad set or ad