v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
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.

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

Path parameters

audienceIdstring required

Request body

Response

Users added

messagestring
numReceivedinteger
numInvalidinteger