# `bird email domains`

## Usage

```bash
bird email domains
```

## Description

Manage the domains Bird sends email from — a message's "from" address must be
on a verified domain listed here.

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.

## Procedure

**Register and verify a sending domain**

Create a sending domain, add the returned DNS records at your DNS provider, then verify until it is green. DNS propagation is asynchronous.

1. `bird email domains create` — Returns the domain in `pending` with the `dns_records` to configure. Add the returned DNS records at your DNS provider. Next: bird email domains get or bird email domains verify
2. `bird email domains verify` — Triggers a fresh DNS check and returns the updated domain.

## Commands

| Name                                                 | Description                                                        |
| ---------------------------------------------------- | ------------------------------------------------------------------ |
| [`create`](/docs/cli/reference/email-domains-create) | Register a sending domain and return the DNS records to configure. |
| [`delete`](/docs/cli/reference/email-domains-delete) | Delete a sending domain                                            |
| [`get`](/docs/cli/reference/email-domains-get)       | Get a sending domain                                               |
| [`list`](/docs/cli/reference/email-domains-list)     | List sending domains                                               |
| [`update`](/docs/cli/reference/email-domains-update) | Update a sending domain's tracking settings and tracking domain.   |
| [`verify`](/docs/cli/reference/email-domains-verify) | Trigger domain verification                                        |