# cow broadcasts

> Part of the Cowliss docs. Markdown for every page: append `index.md` to its URL. Site map: /llms.txt

<!-- GENERATED by apps/docs/scripts/generate-cli-reference.ts. Do not edit. Regenerate with `pnpm -F cowliss-docs generate`. -->

One email to one list: drafts, previews in the app's look, the test send, and who it would reach.

`cow broadcasts [options] [command]`

### cow broadcasts list

List broadcasts

`cow broadcasts list [options]`

**Options**

| Flag | Description |
| --- | --- |
| `--cursor <cursor>` |  |
| `--limit <n>` |  |
| `--app-id <appId>` |  |
| `--status <status>` | draft \| scheduled \| sending \| sent \| cancelled \| failed |

### cow broadcasts delete

Delete a broadcast draft

`cow broadcasts delete [options] <id>`

### cow broadcasts duplicate

Copy a broadcast into a new draft

`cow broadcasts duplicate [options] <id>`

### cow broadcasts test

Send test to me

`cow broadcasts test [options] <id>`

### cow broadcasts audience

Who a broadcast would reach now

`cow broadcasts audience [options] <id>`

### cow broadcasts stats

What a broadcast did

`cow broadcasts stats [options] <id>`

### cow broadcasts create

create a broadcast draft from a markdown file

`cow broadcasts create [options]`

**Options**

| Flag | Description |
| --- | --- |
| `--file <post.md>` | the broadcast as markdown |
| `--doc <post.json>` | the broadcast as a Maily JSON doc |
| `--app <id>` | default: the appId in cow.json |
| `--list <key>` | the list's key, marketing.\<name> |
| `--subject <subject>` |  |
| `--preview-text <text>` |  |
| `--from <address>` | default: the app's default sender (cow apps look set) |
| `--reply-to <address>` |  |

### cow broadcasts update

replace a broadcast draft's content from a markdown file

`cow broadcasts update [options] <id>`

**Options**

| Flag | Description |
| --- | --- |
| `--file <post.md>` | the broadcast as markdown |
| `--doc <post.json>` | the broadcast as a Maily JSON doc |
| `--force` | overwrite even when it was edited in the dashboard since |
| `--list <key>` | the list's key, marketing.\<name> |
| `--subject <subject>` |  |
| `--preview-text <text>` |  |
| `--from <address>` | default: the app's default sender (cow apps look set) |
| `--reply-to <address>` |  |

### cow broadcasts show

a broadcast's status, counts, subject, preview text and dashboard link

`cow broadcasts show [options] <id>`

**Options**

| Flag | Description |
| --- | --- |
| `--doc` | print its Maily JSON doc instead |
| `--html` | print it rendered as HTML instead |

### cow broadcasts preview

render a markdown file as the broadcast would look, saving nothing

`cow broadcasts preview [options]`

**Options**

| Flag | Description |
| --- | --- |
| `--file <post.md>` | the broadcast as markdown |
| `--doc <post.json>` | the broadcast as a Maily JSON doc |
| `--app <id>` | whose look; default: the appId in cow.json |
| `--out <file.html>` | write the HTML there instead of to stdout |