f81ca70ea6b9

latestOpenAPI 3.1.02026-08-105471692.1 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