---
title: "Add recipients"
method: POST
path: "/whatsapp/broadcasts/{broadcast_id}/recipients"
tags: ["Broadcasts"]
---

# Add recipients

`POST /whatsapp/broadcasts/{broadcast_id}/recipients`

Add up to 1000 recipients to a draft broadcast. Duplicates are skipped.

Recipients use Meta's component syntax with body, header, and button components.

## Request body

- WhatsappBroadcastRecipientsAddRequest
  - `whatsapp_broadcast` object, required
    - `recipients` object[], required
      - `phone_number` string — E.164 phone (required unless whatsapp_contact_id provided)
      - `whatsapp_contact_id` string, uuid — Existing contact ID
      - `components` object[] — Meta template components (body, header, button)
        - `type` 'header' | 'body' | 'button', required
        - `sub_type` string — Button sub_type (url, quick_reply)
        - `index` integer — Button index (0-based)
        - `parameters` object[]
          - `type` string — Parameter type (text, image, video, document)
          - `parameter_name` string — Named parameter from template (e.g., first_name, discount_code)
          - `text` string — Text value for text parameters
          - `image` object — Image object for header images
          - `video` object — Video object for header videos
          - `document` object — Document object for header documents

## Response `201`

Added

- WhatsappBroadcastRecipientsAddResponse
  - `data` object, required
    - `added` integer, required
    - `duplicates` integer, required
    - `errors` string[], required

## Other responses

- `401` — Missing or invalid API key
- `404` — Resource not found
- `422` — Request validation failed

---

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