---
title: "bird email blocks validate"
description: "Validate a reusable email section"
canonical: "https://bird.com/docs/cli/reference/email-blocks-validate"
---

# `bird email blocks validate`

## Usage

```bash
bird email blocks validate [flags]
```

## Description

Validate a reusable email section

Check an unsaved section against the rules publication applies: its structure and the content cell's typography, balanced Liquid, and, for a caller with contact read access, registered contact properties. Without that access no property verdict is returned, and publication still refuses an unregistered or archived property. Returns the plain text derived from it, or 422 naming each field to correct. Saves nothing; each call computes a fresh result.

Build the request from flags, a JSON EmailBlockFragmentValidationRequest body via --body-file ("-" reads
stdin), or both — a flag 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 2 of 7 of "Author a reusable email section and link it into templates". Previous: bird email blocks create. Next: bird email blocks languages set.

## Examples

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

# the body it prints:
```

```json
{
  "fragment": {
    "fragment_html": "<table role=\"presentation\" width=\"100%\" cellpadding=\"0\" cellspacing=\"0\" border=\"0\"><tbody><tr><td lang=\"en\" style=\"font-family: Arial, sans-serif; font-size: 14px; font-style: normal; font-weight: normal; line-height: 20px; letter-spacing: normal; text-align: left; text-transform: none; color: #333333; margin: 0; padding: 16px;\"><p style=\"margin: 0;\">Your disclosure text.</p></td></tr></tbody></table>",
    "serializer_version": 2
  },
  "language": "en"
}
```

## 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` | Deduplication key; a retry with the same key won't act twice |

#### Options

| Name                | Description                                                                           |
| ------------------- | ------------------------------------------------------------------------------------- |
| `--language`        | A language tag in BCP-47 form, for example en or pt-BR. (required; or in --body-file) |
| `--response-schema` | Print the fields this command returns, then exit                                      |

## Related

| Name                                                                        | Description                      |
| --------------------------------------------------------------------------- | -------------------------------- |
| [`bird email blocks create`](/docs/cli/reference/email-blocks-create)       | Create a reusable email block    |
| [`bird email blocks duplicate`](/docs/cli/reference/email-blocks-duplicate) | Duplicate a reusable email block |
| [`bird email blocks get`](/docs/cli/reference/email-blocks-get)             | Get a reusable email block       |
| [`bird email blocks list`](/docs/cli/reference/email-blocks-list)           | List reusable email blocks       |
| [`bird email blocks publish`](/docs/cli/reference/email-blocks-publish)     | Publish a reusable email block   |
| [`bird email blocks update`](/docs/cli/reference/email-blocks-update)       | Update a reusable email block    |

## 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)
