# `bird email broadcasts`

## Usage

```bash
bird email broadcasts
```

## Description

Recipients resolve at dispatch: audience members with an address, minus those suppressed
for the broadcast's category. A broadcast leaves draft once submitted, and a scheduled one
stays editable until dispatch begins. Cancelling never recalls what already went out, and
a draft is deleted rather than cancelled.

Reads return JSON; list is paginated. Mutations take flags and/or a --body-file JSON body (flags overriding); run --example to print the body shape or --dry-run to preview the request. Destructive commands require --yes.

## Commands

| Name                                                                      | Description                           |
| ------------------------------------------------------------------------- | ------------------------------------- |
| [`cancel`](/docs/cli/reference/email-broadcasts-cancel)                   | Cancel a broadcast                    |
| [`counts`](/docs/cli/reference/email-broadcasts-counts)                   | Get a broadcast's audience counts     |
| [`create`](/docs/cli/reference/email-broadcasts-create)                   | Create a broadcast                    |
| [`delete`](/docs/cli/reference/email-broadcasts-delete)                   | Delete a broadcast                    |
| [`get`](/docs/cli/reference/email-broadcasts-get)                         | Get a broadcast                       |
| [`list`](/docs/cli/reference/email-broadcasts-list)                       | List broadcasts                       |
| [`list-events`](/docs/cli/reference/email-broadcasts-list-events)         | List events for a broadcast           |
| [`list-recipients`](/docs/cli/reference/email-broadcasts-list-recipients) | List recipients of a broadcast        |
| [`send`](/docs/cli/reference/email-broadcasts-send)                       | Send a broadcast                      |
| [`update`](/docs/cli/reference/email-broadcasts-update)                   | Update a draft or scheduled broadcast |