# AgentMail Create List Entry

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

Adds an email address or domain to an allow or block list (send, receive, or reply direction) scoped to a specific inbox

## Facts

- Endpoint: POST https://mpp.api.agentmail.to/v0/inboxes/:inbox_id/lists/:direction/:type?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-12
- 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-dba7bcfa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BmLfSKekvP3TqUqhhuFjL

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

Example prompt: Add spam@example.com to the receive block list for inbox inbox_abc123 on AgentMail — reason is 'known spam domain'.

## When to prefer this

Use this endpoint when you need to programmatically manage allow/block lists for a specific AgentMail inbox — for example, to prevent an AI agent from receiving or sending emails to certain addresses or domains, or to whitelist trusted contacts. Prefer this over manual inbox configuration when building automated filtering workflows for AI agents.

## Known failure modes

- 400 Bad Request if entry field is missing or malformed
- 401 Unauthorized if Bearer token is missing or invalid
- 404 Not Found if inbox_id does not exist
- 409 Conflict if the entry already exists on the list
- 422 Unprocessable Entity if direction or type path params are invalid enum values

## How this service works

Create List Entry

## Output

Returns a PodListEntry object containing the entry (email or domain), direction (send/receive/reply), list_type (allow/block), entry_type (email/domain), created_at timestamp, pod_id, organization_id, and optionally inbox_id and reason.

## 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-dba7bcfa/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)