Ad Audiences

Add users to audience

Changed on

Uploads customer emails (and phone numbers on Meta) to a customer list audience, hashed before they are sent.

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

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/ads/audiences/{audienceId}/users
  • Auth: HTTP bearer

Path parameters

audienceIdstring required

The Zernio audience id (the id field of GET /v1/ads/audiences), not the platform segment id.

Request body

Response

Users added

messagestring
numReceivedinteger
numInvalidinteger

Changes

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

  • d556591af3f6Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status