---
title: "Add recipients to a broadcast"
method: POST
path: "/v1/broadcasts/{broadcastId}/recipients"
tags: ["Broadcasts"]
---

# Add recipients to a broadcast

`POST /v1/broadcasts/{broadcastId}/recipients`

Add recipients by contact IDs, raw phone numbers, or from the broadcast's segment filters.

## Path parameters

- `broadcastId` string, required

## Request body

- object
  - `contactIds` string[] — Specific contact IDs to add
  - `phones` string[] — Raw phone numbers (auto-creates contacts). Useful for WhatsApp/Telegram manual entry
  - `useSegment` boolean — Auto-populate from broadcast segment filters

## Response `200`

Recipients added

- object
  - `success` boolean
  - `added` integer — Number of recipients successfully added
  - `skipped` integer — Number skipped (duplicates or missing channels)

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Resource not found

---

[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/51932b099b2f/schema)