---
title: Inboxes
description: Inboxes are the core abstraction — each one is a unique email address.
surface: agent
---

## Creating an Inbox

```bash
POST /v0/inboxes
{
  "display_name": "Support Agent"
}
```

The email address is automatically generated from your organization's subdomain.

## Listing Inboxes

```bash
GET /v0/inboxes
```

Returns all inboxes belonging to your tenant.

## Inbox Operations

- **GET** `/v0/inboxes/{inbox_id}` — Get inbox details
- **PATCH** `/v0/inboxes/{inbox_id}` — Update display name
- **DELETE** `/v0/inboxes/{inbox_id}` — Delete inbox and all associated data
