---
title: "Send Broadcast"
method: POST
path: "/v1/events/{event_slug}/broadcast"
tags: ["Broadcast"]
---

# Send Broadcast

`POST /v1/events/{event_slug}/broadcast`

## Request

- Base URL: `https://developer.eventship.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.eventship.com/v1/events/{event_slug}/broadcast`
- Auth: API key in header `X-API-Key`

Send a message to attendees of an event.

Supports the same filtering options as the web app's broadcast composer:

- Filter by registration status (``confirmed``, ``pending``, ``invited``,
  ``waitlisted``, ``cancelled``, ``declined``). Omit to target the
  default set (confirmed + pending + invited).
- Filter by specific ticket type IDs. Omit to include all ticket types.
- Optionally post the message to the event feed.

Recipients who have opted out of event messages for this host are
automatically excluded. Free-tier hosts are subject to the monthly
email quota; upgrade to Pro for a higher allowance.

## Path parameters

- `event_slug` string, required

## Request body

- ExternalBroadcastRequest: Request to send a broadcast message to event attendees via the API. Mirrors the filtering / targeting options available in the web app's broadcast composer: filter by registration status, ticket type, or both. Omit both filters to target the default audience (confirmed + pending + invited attendees who haven't opted out of event messages).
  - `subject` string, nullable: Email subject line. Optional — if omitted or blank, defaults to "📣 {event title} update" (the same placeholder the web composer pre-fills for hosts).
  - `bodyHtml` string, required: Email body. Plain text or safe HTML.
  - `registrationStatuses` string[], nullable: Filter by registration status. Valid values: 'confirmed', 'pending', 'invited', 'waitlisted', 'cancelled', 'declined'. Omit to target the default set (confirmed, pending, invited).
  - `ticketTypeIds` integer[], nullable: Filter by ticket type IDs. Omit to include all ticket types.
  - `postToFeed` boolean: If true, also post the message to the event's feed.

## Response `200`

Successful Response

- ApiResponseExternalBroadcastResponse
  - `data` ExternalBroadcastResponse, required: Result of sending a broadcast via the external API.
    - `broadcastId` string, required
    - `recipientsCount` integer, required
  - `success` boolean
  - `message` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/eventship/apis/eventship-api.md) · [All operations](https://skmtc.dev/eventship/apis/eventship-api/llms.txt) · [OpenAPI document](https://skmtc.dev/eventship/apis/eventship-api/revisions/4b7e010cb94f?raw)