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

# Create a broadcast

`POST /v4/broadcasts`

Draft or schedule to send a broadcast to all or a subset of your subscribers.<br/><br/>To save a draft, set `send_at` to `null`.<br/><br/>To publish to the web, set `public` to `true`.<br/><br/>To schedule the broadcast for sending, provide a `send_at` timestamp. Scheduled broadcasts should contain a subject and your content, at a minimum.<br/><br/>We currently support targeting your subscribers based on segment or tag ids.<aside class='notice'>Starting point templates are not currently supported.</aside>

## Request body

- object
  - `email_template_id` integer — Id of the email template to use. Uses the account's default template if not provided. 'Starting point' template is not supported.
  - `email_address` string, nullable — The sending email address to use. Uses the account's sending email address if not provided.
  - `content` string, required — The HTML content of the email.
  - `description` string, required
  - `public` boolean, required — `true` to publish this broadcast to the web. The broadcast will appear in a newsletter feed on your Creator Profile and Landing Pages.
  - `published_at` string, required — The published timestamp to display in ISO8601 format. If no timezone is provided, UTC is assumed.
  - `send_at` string, nullable — The scheduled send time for this broadcast in ISO8601 format. If no timezone is provided, UTC is assumed.
  - `thumbnail_alt` string, nullable
  - `thumbnail_url` string, nullable
  - `preview_text` string, required
  - `subject` string, required
  - `subscriber_filter` object[], required — Filters your subscribers. At this time, we only support using only one filter group type via the API (e.g. `all`, `any`, or `none` but no combinations). If nothing is provided, will default to all of your subscribers.
    - `all` object[], required — Filters your subscribers using a logical AND of all provided segment and tag ids, i.e. a subscriber would have to be part of all segments and tags provided
      - `type` 'segment' | 'tag', required — `segment` or `tag`
      - `ids` integer[], required
    - `any` object[], nullable, required — Filters your subscribers using a logical OR of all provided segment and tag ids, i.e. a subscriber would have to be part of at least one of the segments or tags provided
      - `type` 'segment' | 'tag', required — `segment` or `tag`
      - `ids` integer[], required
    - `none` object[], nullable, required — Filters your subscribers using a logical NOT of all provided segment and tag ids, i.e. a subscriber would have to be in none of the segments or tags provided
      - `type` 'segment' | 'tag', required — `segment` or `tag`
      - `ids` integer[], required

## Response `201`

Creates a new broadcast

- object
  - `broadcast` object, required
    - `id` integer, required
    - `publication_id` integer, required
    - `created_at` string, required
    - `subject` string, required
    - `preview_text` string, required
    - `description` string, required
    - `content` string, required
    - `public` boolean, required
    - `published_at` string, required
    - `send_at` string, nullable, required
    - `thumbnail_alt` string, nullable, required
    - `thumbnail_url` string, nullable, required
    - `public_url` string, required
    - `email_address` string, required
    - `email_template` object, required
      - `id` integer, required
      - `name` string, required
    - `subscriber_filter` object[], required
      - `all` object[], required
        - `type` 'segment' | 'tag', required
        - `ids` integer[], required
    - `status` string

## Other responses

- `401` — Returns a 401 if the token and/or account cannot be authenticated
- `403` — Returns a 403 with an error message if the current account is unauthorized to create a broadcast
- `422` — Returns a 422 with an error message when one or more of the parameters were invalid

---

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