# AgentMail List Inboxes

> AgentMail List Inboxes is a free API for AI agents from AgentMail at mpp.api.agentmail.to, Free, status unknown (last checked 2026-10-11).

Lists all email inboxes belonging to a specific AgentMail pod, with pagination support

## Facts

- Endpoint: GET https://mpp.api.agentmail.to/v0/pods/:pod_id/inboxes?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: AgentMail
- Docs: https://docs.agentmail.to
- Website: https://agentmail.to
- Tags: email, inboxes, domains, drafts, threads, webhooks, messaging, ai, social
- Canonical page: https://www.zero.xyz/c/agentmail-inboxes-095812b7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZJNQ_O4PZ8P8byOOyWNT0

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 agentmail-inboxes-095812b7
```

Example prompt: Show me all the email inboxes under my AgentMail pod 'pod_abc123', sorted from oldest to newest.

## When to prefer this

Use this endpoint when you need to enumerate or audit all email inboxes associated with a specific AgentMail pod, especially before performing operations on individual inboxes or when you need to discover inbox IDs dynamically. Prefer this over manually tracking inbox IDs when working with multiple agent inboxes.

## Known failure modes

- pod_id not found — 404 error if the pod does not exist or does not belong to the authenticated user
- missing or invalid Authorization header — 401 unauthorized
- invalid page_token — may return 400 or empty result set
- invalid limit value (e.g. negative number) — 400 bad request
- empty pod with no inboxes — returns count: 0 and empty inboxes array

## How this service works

List Inboxes

## Output

Returns a paginated list of inbox objects for the specified pod, each containing inbox_id, pod_id, display_name (formatted as 'Name <email@domain.com>'), client_id, created_at, updated_at timestamps, plus a total count and optional next_page_token for further pagination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "pod_id"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "title": "Limit",
   "description": "Limit of number of items returned."
  },
  "pod_id": {
   "type": "string",
   "title": "PodId",
   "description": "ID of pod."
  },
  "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/agentmail-inboxes-095812b7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mpp.api.agentmail.to](https://www.zero.xyz/host/mpp.api.agentmail.to/llms.txt)