---
title: "Add users to audience"
method: POST
path: "/v1/ads/audiences/{audienceId}/users"
tags: ["Ad Audiences"]
---

# Add users to audience

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

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.

## Path parameters

- `audienceId` string, required

## Request body

- object
  - `users` object[], required
    - `email` string, email
    - `phone` string

## Response `200`

Users added

- object
  - `message` string
  - `numReceived` integer
  - `numInvalid` integer

## Other responses

- `400` — Invalid input (malformed audienceId, empty users array, missing email/phone)
- `401` — Unauthorized
- `403` — Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans.
- `404` — Resource not found
- `422` — Audience is not a customer_list type or has no platform ID yet

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/revisions/1e9a379eafca/schema)