Add users to 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.

POST /v1/ads/audiences/{audienceId}/users

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.

Parameters

• audienceId (path, string) required

Request body

Content-Type: application/json

• users (array) required

Responses

200 — Users added

• message (string)
• numReceived (integer)
• numInvalid (integer)

400 — Invalid input (empty users array, missing email/phone)

401

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

404

422 — Audience is not a customer_list type or has no platform ID yet