---
name: "agentmail-inboxes"
description: "AgentMail: Operations on inboxes"
---

# inboxes

> **PREREQUISITE:** Read `../agentmail-shared/SKILL.md` for auth, global flags, and output formatting. If missing, run `agentmail generate-skills` to create it.

```bash
agentmail inboxes <method> [flags]
```

## API Resources

 - `create` — Create Inbox
 - `delete` — Delete Inbox
 - `get` — Get Inbox
 - `list` — List Inboxes
 - `update` — Update Inbox

### api-keys

 - `create` — Create API Key
 - `delete` — Delete API Key
 - `list` — List API Keys

### browser-credentials

 - `create-enrollment` — Create Browser Enrollment

### drafts

 - `create` — Create Draft
 - `delete` — Delete Draft
 - `get` — Get Draft
 - `get-attachment` — Get Attachment
 - `list` — List Drafts
 - `send` — Send Draft
 - `update` — Update Draft

### events

 - `list` — List Inbox Events

### lists

 - `create` — Create List Entry
 - `delete` — Delete List Entry
 - `get` — Get List Entry
 - `list` — List Entries

### messages

 - `batch-get` — Batch Get Messages
 - `batch-update` — Batch Update Messages
 - `delete` — Delete Message
 - `forward` — Forward Message
 - `get` — Get Message
 - `get-attachment` — Get Attachment
 - `get-raw` — Get Raw Message
 - `list` — List Messages
 - `reply` — Reply To Message
 - `reply-all` — Reply All Message
 - `search` — Search Messages
 - `send` — Send Message
 - `update` — Update Message

### metrics

 - `query-events` — Query Events
 - `query-usage` — Query Usage

### threads

 - `delete` — Delete Thread
 - `get` — Get Thread
 - `get-attachment` — Get Attachment
 - `list` — List Threads
 - `search` — Search Threads
 - `update` — Update Thread

### webhooks

 - `create` — Create Webhook
 - `delete` — Delete Webhook
 - `get` — Get Webhook
 - `get-headers` — Get Webhook Headers
 - `list` — List Webhooks
 - `update` — Update Webhook
 - `update-headers` — Update Webhook Headers
## Discovering Commands

**Agents: always prefer `--schema` over `--help`** — `--schema` returns JSON; `--help` returns human prose.

```bash
# Machine-readable surface (use this)
agentmail inboxes --schema
agentmail inboxes <method> --schema

# Human-readable help (for humans)
agentmail inboxes --help
```