---
title: "Create broadcast"
method: POST
path: "/api/v1/broadcast"
tags: ["Messages"]
---

# Create broadcast

`POST /api/v1/broadcast`

The method is used for creating broadcasts for Email, SMS, Mobile Push, Web Push, Viber, Telegram channels.

## Request body

- NewBroadcastRequest
  - `title` string — Broadcast title
  - `messageId` string, required — Message ID
  - `groups` integer[], required
  - `excludedGroups` integer[]
  - `startDate` string — The broadcast start date. Use the following format: "YYYY-MM-DDTHH:mm". If not specified, the broadcast starts immediately
  - `batchSize` integer — The broadcasting speed management parameter, the number of messages per specified time interval.
  - `batchIntervalUnit` 'MINUTE' | 'HOUR' | 'DAY' | 'MONTH' — The broadcasting speed management parameter—the time interval.
  - `domain` string — Broadcast domain. For web push messages.
  - `appId` string — Application ID. For mob push and telegram messages.

## Response `200`

---

[API](https://skmtc.net/esputnik/apis/esputnik-com.md) · [All operations](https://skmtc.net/esputnik/apis/esputnik-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/esputnik/esputnik-com/versions/1c4afd7ba72a/schema)