> ## Documentation Index
> Fetch the complete documentation index at: https://openmail-docs-reputation-lifecycle-webhooks.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Inboxes

> Every OpenMail agent gets a dedicated email address and inbox. Learn how to create, configure, and manage inboxes via API or CLI.

An inbox is a unique email address assigned to an agent. When you create an inbox, the agent can immediately send and receive email from that address.

## Address format

Inboxes use the `openmail.sh` domain:

```
{mailboxName}@openmail.sh
```

For example: `support@openmail.sh`

* If you provide a `mailboxName`, it becomes the local part of the address
* If you omit it, we generate a random 8-character alphanumeric string
* Mailbox names must be 3–30 characters, lowercase alphanumeric with dots and hyphens allowed

Need your own domain (e.g. `agent@yourdomain.com`)? See [Custom domains](/concepts/custom-domains).

## Sender name

Set `displayName` when creating or updating an inbox to control how recipients see the sender. Without a display name, recipients see the raw email address. With a display name, the From header becomes `Name <address>`.

```json theme={"theme":{"light":"github-light","dark":"dark-plus"}}
{
  "displayName": "John Smith",
  "mailboxName": "john"
}
```

Recipients will see **John Smith** instead of the raw email address. You can update the display name at any time with `PATCH /v1/inboxes/:id`.

## Multi-tenant routing

Route inbound events by `inbox_id`. Map each inbox ID to your user/agent/container in your app.

**Multi-tenant** - One account, many inboxes. Create one inbox per agent and route by `inbox_id`.

**Multiple inboxes per user** - You can create multiple inboxes for the same user. Webhooks include `inbox_id` so you can identify which inbox received the message.

<Tip>
  See [Email deliverability](/best-practices/email-deliverability) for warm-up schedules and content best practices.
</Tip>

## Limits

| Plan      | Max inboxes |
| --------- | ----------- |
| Free      | 3           |
| Developer | 10          |
| Launch    | 200         |

## Lifecycle

Deleting an inbox (`DELETE /v1/inboxes/:id`) permanently removes the inbox and all associated messages, threads, and attachments. This is not reversible.