> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sentfrom.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Inboxes

> Email addresses your agents send and receive from.

An **inbox** is an email address your agent owns. Inboxes send and receive mail,
group messages into threads, and are the unit you provision per agent, user, or task.

## Create an inbox

```bash theme={null}
curl -X POST https://api.sentfrom.ai/v1/inboxes \
  -H "Authorization: Bearer sf_live_…" -H "Content-Type: application/json" \
  -d '{ "local_part": "support-bot", "display_name": "Support" }'
```

```json Response theme={null}
{
  "id": "b1f2…",
  "local_part": "support-bot",
  "display_name": "Support",
  "address": "support-bot@mail.sentfrom.ai"
}
```

| Field          | Required | Notes                                                                                          |
| -------------- | -------- | ---------------------------------------------------------------------------------------------- |
| `local_part`   | yes      | The part before the `@`. Lowercased automatically; `[a-z0-9._-]` only.                         |
| `display_name` | no       | Friendly From name on outbound mail.                                                           |
| `domain_id`    | no       | A verified [custom domain](/guides/custom-domains). Defaults to the shared `mail.sentfrom.ai`. |

<Note>
  Addresses are **globally unique** on the shared domain. Re-using a `local_part`
  that's already taken returns `409 address_taken`.
</Note>

## List & delete

```bash theme={null}
curl https://api.sentfrom.ai/v1/inboxes -H "Authorization: Bearer sf_live_…"
curl -X DELETE https://api.sentfrom.ai/v1/inboxes/INBOX_ID -H "Authorization: Bearer sf_live_…"
```

## Inbox limits

Each plan includes a number of concurrent inboxes. Creating one past your limit
returns `402 inbox_limit_reached` with `upgrade: true`.

| Plan     | Inboxes |
| -------- | ------- |
| Free     | 3       |
| Pro      | 100     |
| Scale    | 1,500   |
| Business | 15,000  |

Agents typically create **one inbox per user or task**, so generous limits matter
— see the [dashboard](https://console.sentfrom.ai) for your current usage.