# AgentMail List Pod Allow/Block Entries

> AgentMail List Pod Allow/Block Entries is a free API for AI agents from AgentMail at mpp.api.agentmail.to, Free, status unknown (last checked 2026-09-21).

Lists allow or block list entries for a pod, filtered by direction (send/receive/reply) and type (allow/block)

## Facts

- Endpoint: GET https://mpp.api.agentmail.to/v0/pods/:pod_id/lists/:direction/:type
- Price: Free
- Status: unknown
- Last checked: 2026-09-21
- 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-type-1f5ba5df
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KOTVffpo1wXDhfJKKSw-k

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-type-1f5ba5df
```

Example prompt: Show me all the blocked entries for the 'receive' direction on pod abc123 in AgentMail — I want to see which email addresses and domains are on the block list.

## When to prefer this

Use this endpoint when you need to inspect the current state of allow or block lists for a specific pod in AgentMail — for example, to audit which senders are blocked, verify that an address was added to an allowlist, or enumerate all access-control entries before making changes. Prefer this over creating or deleting entries when the goal is read-only inspection or compliance checking.

## Known failure modes

- Invalid pod_id returns 404 not found
- Invalid direction or type enum value returns 400 bad request
- Missing required path parameters returns 422 unprocessable entity
- Expired or missing Authorization token returns 401 unauthorized
- No entries exist for the given filters returns empty entries array with count 0
- Invalid page_token returns 400 or empty results

## How this service works

List Entries

## Output

Returns a paginated list of allow or block list entries for the specified pod and direction. Each entry includes the email address or domain, whether it's email- or domain-scoped, the direction, list type, creation timestamp, optional inbox scope, optional reason, and organization ID. Also includes a count and optional next_page_token for pagination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "pod_id",
  "direction",
  "type"
 ],
 "properties": {
  "type": {
   "enum": [
    "allow",
    "block"
   ],
   "type": "string",
   "title": "ListType",
   "description": "Type of list entry."
  },
  "limit": {
   "type": "integer",
   "title": "Limit",
   "description": "Limit of number of items returned."
  },
  "pod_id": {
   "type": "string",
   "title": "PodId",
   "description": "ID of pod."
  },
  "direction": {
   "enum": [
    "send",
    "receive",
    "reply"
   ],
   "type": "string",
   "title": "Direction",
   "description": "Direction of list entry."
  },
  "page_token": {
   "type": "string",
   "title": "PageToken",
   "description": "Page token for pagination."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "PodListListEntriesResponse",
 "required": [
  "count",
  "entries"
 ],
 "properties": {
  "count": {
   "type": "integer",
   "title": "Count",
   "description": "Number of items returned."
  },
  "limit": {
   "type": "integer",
   "title": "Limit",
   "description": "Limit of number of items returned."
  },
  "entries": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "PodListEntry",
    "required": [
     "entry",
     "organization_id",
     "direction",
     "list_type",
     "entry_type",
     "created_at",
     "pod_id"
    ],
    "properties": {
     "entry": {
      "type": "string",
      "description": "Email address or domain of list entry."
     },
     "pod_id": {
      "type": "string",
      "description": "ID of pod."
     },
     "reason": {
      "type": "string",
      "description": "Reason for adding the entry."
     },
     "inbox_id": {
      "type": "string",
      "description": "ID of inbox, if entry is inbox-scoped."
     },
     "direction": {
      "enum": [
       "send",
       "receive",
       "reply"
      ],
      "type": "string",
      "title": "Direction",
      "description": "Direction of list entry."
     },
     "list_type": {
      "enum": [
       "allow",
       "block"
      ],
      "type": "string",
      "title": "ListType",
      "description": "Type of list entry."
     },
     "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "Time at which entry was created."
     },
     "entry_type": {
      "enum": [
       "email",
       "domain"
      ],
      "type": "string",
      "title": "EntryType",
      "description": "Whether the entry is an email address or domain."
     },
     "organization_id": {
      "type": "string",
      "title": "OrganizationId",
      "description": "ID of organization."
     }
    }
   },
   "description": "Ordered by entry ascending."
  },
  "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-type-1f5ba5df/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)