---
title: "Update a broadcast"
method: PUT
path: "/v4/broadcasts/{id}"
tags: ["Broadcasts"]
---

# Update a broadcast

`PUT /v4/broadcasts/{id}`

Update an existing broadcast. Continue to draft or schedule to send a broadcast to all or a subset of your subscribers.<br/><br/>To save a draft, set `public` to false.<br/><br/>To schedule the broadcast for sending, set `public` to true and provide `send_at`. 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.

## Path parameters

- `id` integer, required

## Request body

- object
  - `email_template_id` integer, required — 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, required — 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, required — The scheduled send time for this broadcast in ISO8601 format. If no timezone is provided, UTC is assumed.
  - `thumbnail_alt` unknown, required
  - `thumbnail_url` unknown, required
  - `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` string, 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` string, 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` string, required — `segment` or `tag`
      - `ids` integer[], required

## Response `200`

Updates the broadcast and returns its details

- 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, required
    - `thumbnail_alt` unknown, required
    - `thumbnail_url` unknown, 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` string, 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
- `404` — Returns a 404 when the provided id does not exist
- `422` — Returns a 422 with an error message when one or more of the parameters are invalid or the campaign has already started sending

---

[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/revisions/0df0c90d12da/schema)