Create custom audience

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

POST /v1/ads/audiences

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

Request body

Content-Type: application/json

• accountId (string) required
• adAccountId (string) required — Must start with act_
• name (string) required
• description (string)
• type (string) required (enum: customer_list, website, lookalike)
• pixelId (string) — Required for website audiences
• retentionDays (integer) — Required for website audiences
• sourceAudienceId (string) — Required for lookalike audiences
• country (string) — 2-letter code, required for lookalike audiences
• ratio (number) — Required for lookalike audiences
• rule (object) — Pixel event rule for website audiences (optional)
• customerFileSource (string) — Data source declaration for GDPR compliance (customer_list only)

Responses

201 — Audience created

• audience (object)
• message (string)

400 — Missing required fields

401

403 — Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans.