# AgentMail Create Pod List Entry

> AgentMail Create Pod List Entry is a paid API for AI agents from AgentMail at mpp.api.agentmail.to, $0.01/call, status unknown (last checked 2026-10-11).

Adds an email address or domain to a pod's allow or block list for a specific mail direction (send, receive, or reply)

## Facts

- Endpoint: POST https://mpp.api.agentmail.to/v0/pods/:pod_id/lists/:direction/:type?utm_source=zero.xyz
- Price: $0.01/call
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 1
- 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-675138c8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6TlHjTqXEvLORr8AxVC7e

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-675138c8 -d '<json body>'
```

Example prompt: Add 'spam@example.com' to the block list for the 'receive' direction on pod 'pod_abc123' in AgentMail — reason: unwanted promotional emails.

## When to prefer this

Use this endpoint when you need to programmatically control which email addresses or domains an AgentMail pod can communicate with in a given direction. Ideal for setting up automated email access policies for AI agents, enforcing allowlists or blocklists on agent inboxes, or dynamically restricting communication partners as part of an agentic workflow.

## Known failure modes

- Missing required 'entry' field returns a 400 validation error
- Invalid 'direction' path parameter (not send/receive/reply) returns 422
- Invalid 'type' path parameter (not allow/block) returns 422
- Unknown pod_id returns 404
- Missing or invalid Authorization Bearer token returns 401
- Duplicate entry for same pod/direction/type/entry combination may return 409 or silently succeed

## How this service works

Create List Entry

## Output

Returns a PodListEntry object confirming the new list entry, including the email or domain added, the pod_id, direction (send/receive/reply), list_type (allow/block), entry_type (email/domain), organization_id, and the created_at timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "CreateListEntryRequest",
 "required": [
  "entry"
 ],
 "properties": {
  "entry": {
   "type": "string",
   "description": "Email address or domain to add."
  },
  "reason": {
   "type": "string",
   "description": "Reason for adding the entry."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentmail-type-675138c8/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)