Skip to main content
POST
Create broadcast

Authorizations

Authorization
string
header
required

API token from the Zenedu dashboard

Path Parameters

bot
integer
required

Bot ID

Body

application/json
name
string
required

Broadcast name

Maximum string length: 255
text
string | null

Message text

Whether to show link previews

settings
object

Message display settings

filters
object

Recipient filters (same shape as subscriber filters)

telegram_file_ids
integer[]

IDs of files registered via POST /api/v1/bot/{bot}/telegram-files to attach to this broadcast (photos, videos, documents, etc.). The given set replaces the current attachments entirely. Only files you uploaded that are not yet attached to anything are accepted — an already-attached, non-existent, or another user's id returns 422 (telegram_file_ids: Not found). Omit the field or send an empty array to leave attachments unchanged; null is rejected with 422. To remove an attachment, use DELETE …/broadcasts/{broadcast}/attachments/{file}.

Response

Broadcast created

data
object