---
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 — The name of the broadcast. For example, Campaign 1.
  - `description` string, required — The description of the broadcast. For example, Details of campaign 1.
  - `phone_number_list` string, 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.
  - `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` integer[], 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 — The date and time in which leads associated with broadcast are called. The format is: yyyy-mm-dd hh:mm:ss (For example: 2019-12-02 00:00:00).
  - `end_date_time` string, required — The date and time in which leads are associated with broadcast are called. The format is: yyyy-mm-dd hh:mm:ss (For example: 2019-12-02 00:02:00).
  - `time_group` string, required — Unique ID of the time_group to be associated with broadcast.
  - `dialstatus` integer[], required — [1, 2, 3, 4, 5]
  - `retry_dialstatus` integer[], required — [1, 3]

## Response `200`

200

- object

## Other responses

- `400` — 400

---

[API](https://skmtc.net/tatatelebusiness/apis/smartflo-base-api-config.md) · [All operations](https://skmtc.net/tatatelebusiness/apis/smartflo-base-api-config/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tatatelebusiness/smartflo-base-api-config/revisions/6d23fb7bf7e1/schema)