---
title: "bird email broadcasts validate"
description: "validate a broadcast"
canonical: "https://bird.com/docs/cli/reference/email-broadcasts-validate"
---

# `bird email broadcasts validate`

## Usage

```bash
bird email broadcasts validate <broadcast-id> [flags]
```

## Description

validate a broadcast

Check the saved broadcast or the changes supplied in this request against the template's published content, without saving changes, selecting a template version for sending or evaluating recipients. Requires broadcast and template read permission.

Build the request from the &lt;broadcast\_id> argument and flags, a JSON EmailBroadcastValidationRequest body via
--body-file ("-" reads stdin), or both — an inline value overrides the matching
body field. Run --example to print a ready-to-edit body, or --dry-run to print
the resolved request without sending it.

## Procedure

Step 3 of 5 of "Preview and test a broadcast". Previous: bird email templates parameters. Next: bird email broadcasts preview.

## Examples

```bash
# print the body shape (no credentials needed)
bird email broadcasts validate --example

# the body it prints:
```

```json
{
  "from": "Jane Doe <jane@acme.com>",
  "headers": {
    "X-Campaign": "spring-launch"
  }
}
```

## Options

#### Request

| Name                | Description                                                                                                           |
| ------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `--body-file`       | Read the JSON request body from this file; "-" reads stdin                                                            |
| `--example`         | Print a complete example request body, then exit                                                                      |
| `--dry-run`         | Print the resolved request without sending it, then exit                                                              |
| `--idempotency-key` | Accepted for this POST request. Each call computes a fresh result; reusing the key does not replay an earlier result. |

#### Options

| Name                    | Description                                                                                                              |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `--template`            | Override the template ID                                                                                                 |
| `--language`            | Override the selected template language                                                                                  |
| `--parameters`          | Complete authored template input map as JSON; {} clears the map                                                          |
| `--parameter-overrides` | Complete per-language override map as JSON; a name a language leaves out uses --parameters, and {} clears every override |
| `--from`                | Override sender address                                                                                                  |
| `--reply-to <value>…`   | Override reply address; repeatable                                                                                       |
| `--header <key=value>`  | Replace headers as Key=Value                                                                                             |
| `--response-schema`     | Print the fields this command returns, then exit                                                                         |

## Related

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

## Related resources

- [Should I use a Bird SDK or call the API directly?](/explained/platform/should-i-use-an-sdk-or-call-the-api-directly) (answer)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=api-basics)