# `bird email`

## Usage

```bash
bird email
```

## Description

Send and inspect email messages, receive email at inbound addresses, and manage
the email channel's deliverability resources — sending domains, dedicated IPs,
and IP pools — under one group.

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.

## Procedure

**Send an email**

Deliver email to explicit recipients. The sender must be a verified domain, or the shared onboarding domain on a new workspace; the result is `accepted` (queued, delivered asynchronously), not yet delivered.

Requires: The `from` must be a sender the workspace can use: a verified sending domain, or the shared onboarding domain on a new workspace.

1. `bird email send` — Returns `accepted` (HTTP 202), delivered asynchronously; not confirmation of delivery. Next: bird email get

## Messages

| Name                                                 | Description                                 |
| ---------------------------------------------------- | ------------------------------------------- |
| [`send`](/docs/cli/reference/email-send)             | Send an email message.                      |
| [`send-batch`](/docs/cli/reference/email-send-batch) | Send a batch of email messages in one call. |
| [`get`](/docs/cli/reference/email-get)               | Get a message                               |
| [`list`](/docs/cli/reference/email-list)             | List messages                               |
| [`cancel`](/docs/cli/reference/email-cancel)         | Cancel a scheduled message                  |
| [`content`](/docs/cli/reference/email-content)       | Get stored message content                  |
| [`recipients`](/docs/cli/reference/email-recipients) | List recipients of a message                |

## Deliverability

| Name                                                       | Description                       |
| ---------------------------------------------------------- | --------------------------------- |
| [`domains`](/docs/cli/reference/email-domains)             | Manage email sending domains      |
| [`dedicated-ips`](/docs/cli/reference/email-dedicated-ips) | Manage dedicated IPs              |
| [`ip-pools`](/docs/cli/reference/email-ip-pools)           | Manage IP pools                   |
| [`suppressions`](/docs/cli/reference/email-suppressions)   | Manage the email suppression list |
| [`tools`](/docs/cli/reference/email-tools)                 | Email deliverability tools        |

## Inbound

| Name                                                               | Description                              |
| ------------------------------------------------------------------ | ---------------------------------------- |
| [`inbound-addresses`](/docs/cli/reference/email-inbound-addresses) | Manage inbound (forward) email addresses |
| [`inbound-messages`](/docs/cli/reference/email-inbound-messages)   | Read received (inbound) emails           |

## Analytics

| Name                                       | Description                     |
| ------------------------------------------ | ------------------------------- |
| [`stats`](/docs/cli/reference/email-stats) | Read aggregate email statistics |