{"uid":"cap_l2OWl_lepwObdPmDnACei","slug":"mermail-list-mailboxes-28351d2d","name":"Mermail List Mailboxes","description":"An inbox and wallet for your AI agent. Find and nurture sales leads, resolve customer support, and handle online purchases with controlled payments.","url":"https://console.mermail.app/api/agent/v1/mailboxes?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"array","items":{"type":"object","required":["id","public_id","workspace_id","email","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string","format":"email"},"public_id":{"type":"string","format":"uuid"},"can_receive":{"type":"boolean"},"workspace_id":{"type":"string"},"receiving_status":{"enum":["ready","disabled","unavailable"],"type":"string"}},"additionalProperties":true}}}}}},"responseSchema":{"type":"json","example":{"id":"mailbox_1","name":"Support agent","email":"agent@mermail.app","public_id":"11111111-1111-4111-8111-111111111111","can_receive":true,"workspace_id":"workspace_1","receiving_status":"ready"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8KNKNkyE4Gs9VKZUOG683","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"2","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves all mailboxes configured for an AI agent in the Mermail workspace, including their email addresses, receiving status, and identifiers.","exampleAgentPrompt":"Show me all the mailboxes set up in my Mermail workspace so I can see which email addresses my agent can receive messages on and whether they're ready to use.","exampleUseCases":[{"title":"Support inbox for an agent fleet","prompt":"List all the Mermail mailboxes in my workspace so I can see which ones are active and ready to handle incoming customer support emails."},{"title":"Sales lead routing setup","prompt":"Show me every email inbox my Mermail agent has configured — I want to find the one labeled 'Sales agent' and confirm it can receive messages before routing leads to it."},{"title":"Agent onboarding check","prompt":"Pull up all my Mermail mailboxes and tell me their receiving status so I can verify everything is set up correctly before launching my new AI agent."}],"resultDescription":"Returns a list of mailbox objects, each containing the mailbox ID, human-readable name, assigned email address, UUID public_id, workspace_id, a boolean can_receive flag, and a receiving_status enum value ('ready', 'disabled', or 'unavailable').","failureModes":["Authentication failure (missing or invalid payment/auth header) returns 402 Payment Required","Workspace with no configured mailboxes returns an empty array","Invalid query parameters may return 400 Bad Request","Service unavailability returns 503 or 500 error","Network timeout if the Mermail API is unresponsive"],"whenToPreferThis":"Use this endpoint when an AI agent needs to discover or enumerate its available email mailboxes before reading messages, routing communications, or verifying inbox readiness. It is the correct first step before calling any message-fetching or inbox-management endpoints within the Mermail ecosystem.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:41:41.127Z","isFirstParty":false,"canonicalSlug":"mermail-list-mailboxes-28351d2d"}