# AgentMail List Pods

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

Lists all pods (top-level organizational units) in an AgentMail account with pagination support

## Facts

- Endpoint: GET https://mpp.api.agentmail.to/v0/pods?utm_source=zero.xyz
- Price: Free
- Payment: MPP
- 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-pods-e7a427ee
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0OCbHG8JM_KTVlZnLLO1B

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-pods-e7a427ee
```

Example prompt: Show me all my AgentMail pods — list up to 20, sorted by newest first.

## When to prefer this

Use this endpoint when you need to discover or enumerate all pods associated with an AgentMail account, especially before performing operations on specific pods (like creating inboxes or managing domains). Prefer this when paginating through large pod collections or when you need to find a pod_id by name.

## Known failure modes

- Missing or invalid Authorization header returns 401 Unauthorized
- Invalid page_token returns 400 Bad Request or empty result
- Non-integer limit value returns 400 validation error
- Expired or revoked API key returns 403 Forbidden
- Network timeout returns 5xx server error

## How this service works

List Pods

## Output

Returns an array of pod objects each containing pod_id, name, client_id, created_at, and updated_at timestamps, along with the total count of items returned, the applied limit, and a next_page_token for fetching subsequent pages if more pods exist.

## 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": "ListPodsResponse",
 "required": [
  "count",
  "pods"
 ],
 "properties": {
  "pods": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "Pod",
    "required": [
     "pod_id",
     "name",
     "updated_at",
     "created_at"
    ],
    "properties": {
     "name": {
      "type": "string",
      "title": "Name",
      "description": "Name of pod."
     },
     "pod_id": {
      "type": "string",
      "title": "PodId",
      "description": "ID of pod."
     },
     "client_id": {
      "type": "string",
      "title": "ClientId",
      "description": "Client ID of pod."
     },
     "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "Time at which pod was created."
     },
     "updated_at": {
      "type": "string",
      "format": "date-time",
      "description": "Time at which pod was last updated."
     }
    }
   },
   "description": "Ordered by `created_at` descending."
  },
  "count": {
   "type": "integer",
   "title": "Count",
   "description": "Number of items returned."
  },
  "limit": {
   "type": "integer",
   "title": "Limit",
   "description": "Limit of number of items returned."
  },
  "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-pods-e7a427ee/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)