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

# Create a broadcast

`POST /broadcasts`

## Request body

- CreateBroadcastInput
  - `name` string, required
  - `from` string, required
  - `subject` string, required
  - `html` string, required
  - `text` string
  - `segment_ids` string[]
  - `topic_id` string
  - `scheduled_at` string, date-time
  - `ab_test` object — Enable A/B testing. Each variant is sent to a share of the audience; the winner (highest open rate) is picked after test_duration_minutes and sent to the rest.
    - `variants` object[], required
      - `name` string, required
      - `subject` string, required
      - `html` string
      - `text` string
      - `weight` integer, required
    - `test_duration_minutes` integer, required

## Response `200`

OK

- object
  - `success` boolean

---

[API](https://skmtc.dev/poststack/apis/poststack-api.md) · [All operations](https://skmtc.dev/poststack/apis/poststack-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/poststack/poststack-api/revisions/0f5bfcfae749/schema)