---
title: "Add batches to a text broadcast"
method: POST
path: "/texts/broadcasts/{id}/batches"
tags: ["texts"]
---

# Add batches to a text broadcast

`POST /texts/broadcasts/{id}/batches`

Allows adding an extra batches to an already created text broadcast campaign. The batches which being  added pass the CallFire validation process (unlike in the recipients version of this API). That is why using of a scrubDuplicates flag remove duplicates from your batch. Batches may be added as a contact list id, a list of contact ids, or a list of numbers

## Path parameters

- `id` integer, required

## Query parameters

- `strictValidation` boolean

## Request body

- BatchRequest — Request object is used for adding new batch to an existing broadcast
  - `name` string — A name of batch
  - `contactListId` integer — An id of existing contact list
  - `recipients` Recipient[] — A list of Recipient objects. For each recipient you can set its phone number or existing contact id to use contact which already exists in account
    - `phoneNumber` string — A recipient's phone number in E.164 format (11-digit) or short code. Example: 12132000384, 67076
    - `fromNumber` string — ~
    - `contactId` integer — An id of existing contact used as recipient
    - `attributes` object — Map of user-defined string attributes associated with recipient
  - `scrubDuplicates` boolean — Removes duplicate recipients from batch if true

## Response `201`

successful operation

- ResourceId — An id of a resource
  - `id` integer — An id of a resource

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/callfire/apis/callfire-api-documentation.md) · [All operations](https://skmtc.net/callfire/apis/callfire-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/callfire/callfire-api-documentation/versions/9f6fb501bc03/schema)