Back to Browse
AgentMail List Entries
emailinboxesdomainsdraftsthreadswebhooks
AgentMail List Entries is a free API for AI agents from AgentMail at mpp.api.agentmail.to, Free, status unknown (last checked 2026-10-12).
Lists all allow or block list entries for a specific inbox, filtered by direction (send/receive/reply) and list type (allow/block)
Price / callFree
Success—
StatusUnknown
How this service works
List Entries
Output
Returns a paginated list of allow or block list entries for the specified inbox and direction, including each entry's email address or domain, entry type, reason, timestamps, and organization/pod IDs, along with a count and optional next page token.
Example use cases
Audit incoming sender restrictions
“Can you show me everyone who's blocked from sending emails to my inbox? I need to review my receive block list to make sure we haven't accidentally blocked any important contacts.”
Verify outbound email domain blocks
“Pull up all the domains we're blocking for outgoing emails from my agent inbox — I want to make sure our send block list is configured correctly before we start using this account for customer communications.”
Debug reply filtering configuration
“I'm having trouble with email replies not getting through to one of my inboxes. Can you list all the blocked entries in the reply direction so I can see if someone's accidentally blocked there?”
Technical details
Endpoint
GEThttps://mpp.api.agentmail.to/v0/inboxes/:inbox_id/lists/:direction/:type?utm_source=zero.xyzWhen to prefer
Use this endpoint when you need to inspect the current allow or block list configuration for a specific inbox in AgentMail, particularly when auditing filtering rules, debugging email delivery issues, or building UIs that display inbox access control settings. Prefer this over the Create List Entry endpoint when you only need to read existing entries without modification.
Side effects
- Invalid inbox_id returns 404 not found
- Invalid direction value (not send/receive/reply) returns 400 validation error
- Invalid type value (not allow/block) returns 400 validation error
- Missing or invalid Authorization header returns 401 unauthorized
- No entries matching criteria returns empty entries array with count 0
- Invalid page_token returns 400 or empty result
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| typerequired | string | Type of list entry. |
| limit | integer | Limit of number of items returned. |
| inbox_idrequired | string | The ID of the inbox. |
| directionrequired | string | Direction of list entry. |
| page_token | string | Page token for pagination. |
Output
Schema · Response
| Field | Type | Description |
|---|---|---|
| countrequired | integer | Number of items returned. |
| limit | integer | Limit of number of items returned. |
| entriesrequired | array | Ordered by entry ascending. |
| next_page_token | string | Page token for pagination. |
Tags
emailinboxesdomainsdraftsthreadswebhooksmessagingaisocial
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"