# AgentMail Delete List Entry

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

Removes a specific email address or domain from an allow or block list for a given message direction (send, receive, or reply)

## Facts

- Endpoint: DELETE https://mpp.api.agentmail.to/v0/lists/:direction/:type/:entry?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-entry-a08ca553
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UuOiwAhaTX3K0_payh5OP

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

Example prompt: Remove 'spam@example.com' from the receive block list on my AgentMail inbox — it should no longer be blocked for incoming messages.

## When to prefer this

Use this endpoint when you need to revoke a previously created allow or block list entry for a specific direction on an AgentMail agent inbox. Ideal for dynamically managing email filtering rules in automated workflows, such as unblocking a sender after a dispute is resolved or removing an expired allow-list domain.

## Known failure modes

- Entry not found — the email or domain does not exist in the specified list (404)
- Invalid direction value — must be one of send, receive, or reply (422/400)
- Invalid type value — must be allow or block (422/400)
- Unauthorized — missing or invalid Bearer token (401)
- Malformed entry — entry is not a valid email address or domain format (400)

## How this service works

Delete List Entry

## Output

A confirmation that the specified email address or domain entry has been deleted from the indicated allow or block list for the given direction (send, receive, or reply). No content body is typically returned on success.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "direction",
  "type",
  "entry"
 ],
 "properties": {
  "type": {
   "enum": [
    "allow",
    "block"
   ],
   "type": "string",
   "title": "ListType",
   "description": "Type of list entry."
  },
  "entry": {
   "type": "string",
   "description": "Email address or domain."
  },
  "direction": {
   "enum": [
    "send",
    "receive",
    "reply"
   ],
   "type": "string",
   "title": "Direction",
   "description": "Direction of list entry."
  }
 }
}
```

## More

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