# broadcasts Detailed flag specifications for `resend broadcasts` commands. --- ## broadcasts list | Flag | Type | Default | Description | |------|------|---------|-------------| | `--limit ` | number | 10 | Max results (1-100) | | `--after ` | string | — | Forward pagination | | `--before ` | string | — | Backward pagination | --- ## broadcasts create | Flag | Type | Required | Description | |------|------|----------|-------------| | `--from
` | string | Yes | Sender address | | `--subject ` | string | Yes | Email subject | | `--segment-id ` | string | Yes | Target segment | | `--html ` | string | At least one body flag | HTML body (supports `{{{PROPERTY\|fallback}}}`) | | `--html-file ` | string | At least one body flag | Path to HTML file (use `"-"` for stdin) | | `--text ` | string | At least one body flag | Plain-text body | | `--react-email ` | string | At least one body flag | Path to React Email template (.tsx) — bundles and renders to HTML. Compatible with `--text` for plain-text fallback | | `--text-file ` | string | At least one body flag | Path to plain-text file (use `"-"` for stdin) | | `--name ` | string | No | Internal label | | `--reply-to
` | string | No | Reply-to address | | `--preview-text ` | string | No | Preview text | | `--topic-id ` | string | No | Topic for subscription filtering | | `--send` | boolean | No | Send immediately (default: save as draft) | | `--scheduled-at ` | string | No | Schedule delivery — ISO 8601 or natural language (only with `--send`) | --- ## broadcasts get **Argument:** `` — Broadcast ID Returns full object with html/text, from, subject, status (`draft`|`queued`|`sent`), timestamps. --- ## broadcasts send Send a draft broadcast. **Argument:** `` — Broadcast ID | Flag | Type | Required | Description | |------|------|----------|-------------| | `--scheduled-at ` | string | No | Schedule instead of immediate send — ISO 8601 or natural language | **Note:** Dashboard-created broadcasts cannot be sent via API. --- ## broadcasts update **Argument:** `` — Broadcast ID (must be draft) | Flag | Type | Description | |------|------|-------------| | `--from
` | string | Update sender | | `--subject ` | string | Update subject | | `--html ` | string | Update HTML body | | `--html-file ` | string | Path to HTML file | | `--text ` | string | Update plain-text body | | `--react-email ` | string | Path to React Email template (.tsx) — bundles and renders to HTML | | `--name ` | string | Update internal label | --- ## broadcasts delete **Argument:** `` — Broadcast ID | Flag | Type | Required | Description | |------|------|----------|-------------| | `--yes` | boolean | Yes (non-interactive) | Skip confirmation | **Alias:** `rm` --- ## broadcasts open Open a broadcast (or the broadcasts list) in the Resend dashboard. **Argument:** `[id]` — Broadcast ID (omit to open the list)