# `bird email mailboxes`

## Usage

```bash
bird email mailboxes
```

## Description

Create and manage agent email mailboxes — the shared inboxes your AI agents and
support workflows read from. A mailbox has an address, a receive policy that
controls which messages it accepts, a retention tier, and labels for categorising
threads.

Use compose to send an outbound message from a mailbox. Use receive-rules to
filter inbound senders. Use threads and thread messages (under email threads)
to read and reply to conversations in a mailbox.

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.

## Commands

| Name                                                                 | Description                       |
| -------------------------------------------------------------------- | --------------------------------- |
| [`compose`](/docs/cli/reference/email-mailboxes-compose)             | Send a new message from a mailbox |
| [`create`](/docs/cli/reference/email-mailboxes-create)               | Create a mailbox                  |
| [`delete`](/docs/cli/reference/email-mailboxes-delete)               | Delete a mailbox                  |
| [`get`](/docs/cli/reference/email-mailboxes-get)                     | Get a mailbox                     |
| [`labels`](/docs/cli/reference/email-mailboxes-labels)               | List a mailbox's labels           |
| [`list`](/docs/cli/reference/email-mailboxes-list)                   | List mailboxes                    |
| [`receive-rules`](/docs/cli/reference/email-mailboxes-receive-rules) | Manage a mailbox's receive rules  |
| [`restore`](/docs/cli/reference/email-mailboxes-restore)             | Restore a deleted mailbox         |
| [`resume`](/docs/cli/reference/email-mailboxes-resume)               | Resume a suspended mailbox        |
| [`stats`](/docs/cli/reference/email-mailboxes-stats)                 | Mailbox email statistics          |
| [`update`](/docs/cli/reference/email-mailboxes-update)               | Update a mailbox                  |