latestOpenAPI 3.1.02026-08-225721892.2 MB

19fd2b70854e

Ad Audiences

Add users to audience

Upload user data to a customer_list audience. Data is SHA256-hashed server-side before sending to the platform. Email is used on every platform; phone is used on Meta only (other platforms ignore it). On TikTok and Pinterest, the first upload also provisions the audience (deferred create). LinkedIn uploads are full-replace. Max 10,000 users per request.

customer_list only. A LinkedIn company_list audience takes company rows, not people: send those to POST /v1/ads/audiences/{audienceId}/companies. This endpoint 422s for every other audience type.

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

Path parameters

audienceIdstring required

Request body

Response

Users added

messagestring
numReceivedinteger
numInvalidinteger