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

# Add batches to a call broadcast

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

The 'add batch' API allows user to add additional batches to an already created voice broadcast campaign. The added batch will go through the CallFire validation process, unlike in the recipients version of this API. That is why you can use the scrubDuplicates flag to 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)