---
title: "Create broadcast draft"
method: POST
path: "/v1/broadcasts"
tags: ["Broadcasts"]
---

# Create broadcast draft

`POST /v1/broadcasts`

Create a broadcast in draft status. Add recipients and then send or schedule it.

## Request body

- object
  - `profileId` string, required
  - `accountId` string, required
  - `platform` 'instagram' | 'facebook' | 'telegram' | 'twitter' | 'bluesky' | 'reddit' | 'whatsapp', required
  - `name` string, required
  - `description` string
  - `message` object
    - `text` string
    - `attachments` object[]
      - `type` string
      - `url` string
      - `filename` string
  - `template` object — WhatsApp template (required when platform is whatsapp)
    - `name` string
    - `language` string
    - `components` object[]
    - `variableMapping` object — Maps template variable positions ("1", "2") to contact fields or static values. Resolved per recipient at send time.
  - `segmentFilters` object
    - `tags` string[]
    - `isSubscribed` boolean

## Response `200`

Broadcast created

- object
  - `success` boolean
  - `broadcast` object
    - `id` string
    - `name` string
    - `description` string
    - `platform` string
    - `accountId` string
    - `status` string
    - `createdAt` string, date-time

## Other responses

- `400` — Invalid request
- `401` — Unauthorized

---

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