# AgentMail List Inboxes

> AgentMail List Inboxes is a paid API for AI agents from x402.api.agentmail.to, paid per call via x402, $2/call, status unknown (last checked 2026-09-15, last successful call 2026-08-08).

Retrieves a list of all email inboxes available in the AgentMail organization for use by AI agents

## Facts

- Endpoint: GET https://x402.api.agentmail.to/v0/inboxes
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Last successful call: 2026-08-08
- Success rate: 100% of calls made through Zero
- Activations on Zero: 5
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-api-agentmail-to-4c0a5322
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hRxxLYTaZjOzar0Na3e_f

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402-api-agentmail-to-4c0a5322
```

Example prompt: Show me all the email inboxes set up in my AgentMail account so I know which ones my agent can send and receive from.

## When to prefer this

Use this endpoint when an AI agent needs to discover which email inboxes are available before sending, reading, or managing email. This is the right starting point for any email workflow — call it first to enumerate available inbox IDs that can then be passed to thread, draft, or message endpoints.

## Known failure modes

- Unauthorized access if credentials are missing or invalid (401)
- No inboxes found if none have been provisioned (empty array)
- Rate limiting if too many requests are made in quick succession (429)
- Service unavailable during maintenance windows (503)

## How this service works

List Inboxes

## Output

A JSON array of inbox objects, each containing inbox identifiers, addresses, and associated metadata for all inboxes provisioned under the agent's organization.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "title": "Limit",
   "description": "Limit of number of items returned."
  },
  "ascending": {
   "type": "boolean",
   "title": "Ascending",
   "description": "Sort in ascending temporal order."
  },
  "page_token": {
   "type": "string",
   "title": "PageToken",
   "description": "Page token for pagination."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "ListInboxesResponse",
 "required": [
  "count",
  "inboxes"
 ],
 "properties": {
  "count": {
   "type": "integer",
   "title": "Count",
   "description": "Number of items returned."
  },
  "limit": {
   "type": "integer",
   "title": "Limit",
   "description": "Limit of number of items returned."
  },
  "inboxes": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "Inbox",
    "required": [
     "pod_id",
     "inbox_id",
     "updated_at",
     "created_at"
    ],
    "properties": {
     "pod_id": {
      "type": "string",
      "title": "PodId",
      "description": "ID of pod."
     },
     "inbox_id": {
      "type": "string",
      "title": "InboxId",
      "description": "The ID of the inbox."
     },
     "client_id": {
      "type": "string",
      "title": "ClientId",
      "description": "Client ID of inbox."
     },
     "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "Time at which inbox was created."
     },
     "updated_at": {
      "type": "string",
      "format": "date-time",
      "description": "Time at which inbox was last updated."
     },
     "display_name": {
      "type": "string",
      "title": "DisplayName",
      "description": "Display name: `Display Name <username@domain.com>`."
     }
    }
   },
   "description": "Ordered by `created_at` descending."
  },
  "next_page_token": {
   "type": "string",
   "title": "PageToken",
   "description": "Page token for pagination."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-api-agentmail-to-4c0a5322/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.api.agentmail.to](https://www.zero.xyz/host/x402.api.agentmail.to/llms.txt)