---
title: "launch"
openapi: "/openapi/broadcasts-api.yaml POST /api/v1/broadcast/broadcasts"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

`POST https://web.otpcod.ru/api/v1/api/v1/broadcast/broadcasts`

## Authentication

No authentication required.

## Header parameters

- `X-API-KEY` (string, required) — Enter your X-API-KEY

## Request body

- Content type: `application/json`
  - request body (object)
    - `description` (string) — Optional description of the broadcast
    - `launchTime` (string, date-time) — Optional scheduled launch time for the broadcast. If not provided, broadcast will be launched immediately after moderation (if required).
    - `name` (string) — Optional name for the broadcast. If not provided, a default name will be generated.
    - `payload` (object)
      - `contentSettings` (object, required)
        - `flowSteps` (array)
          - `items` (object)
            - channelType: … (nested further)
            - contentPattern: … (nested further)
            - deliveryCondition: … (nested further)
            - order: … (nested further)
            - senderId: … (nested further)
            - timeout: … (nested further)
        - `rcsCapabilityCheck` (object)
          - `senderId` (string)
        - `scenario` (object)
          - `channelId` (integer, int32)
          - `flowId` (integer, int64)
          - `senderId` (string)
      - `contentType` (integer, int32, required, one of: 1, 2, 3) — Type of content for the broadcast: 1 - Fallback, 2 - Chat Bot, 3 - RCS Capability Check
      - `rcsCheck` (boolean) — Flag indicating whether RCS check should be performed
    - `recipientsList` (array) — List of recipients for the broadcast
      - `items` (object)
        - `name` (string)
        - `phoneNumber` (string)
    - `templateId` (integer, int64) — ID of an existing template to use for the broadcast. Either templateId or payload must be provided.
    - `webhook` (string, required) — Mandatory webhook URL for receiving broadcast status updates

## Response 201

Created
  - response (object)


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://iba-platform.jamdesk.app/api-specs.zip