Back to Browse
Mermail Mailbox Custom Labels List
x402
Mermail Mailbox Custom Labels List is a paid API for AI agents from console.mermail.app, paid per call via x402, price unknown, status unknown (last checked 2026-10-11).
Retrieves all custom labels defined for a specific Mermail mailbox, returning their IDs and names.
Price / call—
Success—
StatusUnknown
How this service works
An inbox and wallet for your AI agent. Find and nurture sales leads, resolve customer support, and handle online purchases with controlled payments.
Output
Returns a JSON array of custom label objects, each containing an 'id' (e.g. 'label_1') and a 'name' (e.g. 'Follow up'). The list represents all user-defined labels configured for the specified mailbox.
Example use cases
Tag routing for sales leads
“Before my agent starts sorting incoming emails, can you pull all the custom labels from my Mermail mailbox mb_sales01 so I know which ones exist for flagging leads and follow-ups?”
Customer support label audit
“List all the custom labels in my Mermail support mailbox mb_support99 — I want to see what categories we're using to organize customer tickets.”
Pre-labeling workflow setup
“Fetch the available custom labels from Mermail mailbox mb_agent42 so my AI can choose the right one before it processes and labels each incoming message.”
Technical details
Endpoint
GEThttps://console.mermail.app/api/agent/v1/mailboxes/%7BmailboxId%7D/custom-labels?utm_source=zero.xyzWhen to prefer
Use this endpoint when an agent needs to discover or enumerate available labels before tagging, filtering, or routing messages in a Mermail mailbox. Prefer this over hardcoding label IDs, as it ensures the agent always works with current, valid label definitions.
Side effects
- Invalid or nonexistent mailboxId returns a 404 not found error
- Missing or invalid authentication returns a 401 or 402 payment-required response
- Mailbox has no custom labels — returns an empty array
- Rate limiting or service unavailability returns 429 or 503
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
Schema · Response
{
"type": "json",
"example": [
{
"id": "label_1",
"name": "Follow up"
}
]
}Tags
x402
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"