---
title: "Create a Broadcast"
method: POST
path: "/v1/broadcast"
---

# Create a Broadcast

`POST /v1/broadcast`

This API allows you to create a Broadcast.

## Headers

- `Authorization` string, required

## Request body

- object
  - `name` string, required — Name for the broadcast.
  - `description` string, required — Description of the broadcast.
  - `phone_number_list` integer, required — Unique ID of list of phone numbers to be used for broadcast.
  - `destination` string, required — The destination where the call should land. eg: ivr||id, id: IVR's id
  - `timeout` string, required — Time for which the call tries to connect to each number in the list. Minimum: 40
  - `concurrent_limit` string, required — Number of channels to be used for broadcast.
  - `retry_after_minutes` string, required — Time after which failed numbers are tried again.
  - `caller_id_number` string — Caller ID that is showed to the called party.
  - `number_of_retry` string — Maximum number of retry attempts allowed. Minimum: 0, Maximum: 5
  - `start_date_time` string, required — Date and time in which leads associated with broadcast are called.
  - `end_date_time` string, required — Date and time till which leads associated with broadcast are called.
  - `time_group` string, required — Unique ID of the time_group to be associated with broadcast.

## Response `200`

200

- object

## Other responses

- `400` — 400

---

[API](https://skmtc.net/servetel/apis/servetel-base-api-config.md) · [All operations](https://skmtc.net/servetel/apis/servetel-base-api-config/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/servetel/servetel-base-api-config/versions/d1cb31356d25/schema)