---
title: "Add audience members"
method: POST
path: "/audience/{id}/members"
tags: ["Audience"]
---

# Add audience members

`POST /audience/{id}/members`

Add new members to an existing audience.

Each member object must include a key matching the audience's `phoneNumberColumnName`.
If it's missing, the API returns 400: `"Each member must have a <phoneNumberColumnName> field"`.
Adding members that would exceed the audience limit also returns 400.

Note: if the audience belongs to a different organization, the API returns 404 (not 403).

## Path parameters

- `id` string, required

## Request body

- object
  - `members` object[], required — Array of member objects with dynamic structure based on audience configuration

## Response `200`

Members added successfully

- object
  - `status` boolean
  - `data` object[]
    - `message` string
    - `data` object
      - `added` integer — Number of members successfully added
      - `skipped` integer — Number of members skipped (e.g., duplicates)

## Other responses

- `400` — Bad request
- `401` — Unauthorized access
- `404` — Audience not found (also returned when audience belongs to a different organization)
- `500` — Internal server error

---

[API](https://skmtc.net/smallest-inc/apis/agent-management-api.md) · [All operations](https://skmtc.net/smallest-inc/apis/agent-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smallest-inc/agent-management-api/revisions/274a178284a4/schema)