{"uid":"cap_1EJc__voNV-Msei572Jmv","slug":"mermail-mailbox-folders-list-e99febff","name":"Mermail Mailbox Folders List","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/%7BmailboxId%7D/folders?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","properties":{"id":{"type":"string"},"name":{"type":"string"}},"additionalProperties":true}}}}}},"responseSchema":{"type":"json","example":[{"id":"inbox","name":"Inbox"}]},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"unprobed","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":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_cSm80RGn7Xvg_1IiOXfEe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the list of folders (e.g. Inbox, Sent, Spam) available within a specific Mermail mailbox for an AI agent.","exampleAgentPrompt":"Can you show me all the folders available in my Mermail mailbox so I can see where my agent's emails are organized?","exampleUseCases":[{"title":"Sales lead inbox organization","prompt":"I need to see what folders my Mermail agent mailbox has — I want to know if there's a separate folder for leads versus regular inbox messages."},{"title":"Customer support triage setup","prompt":"List all the folders in my agent's Mermail mailbox so I can figure out how to route incoming customer support tickets to the right place."},{"title":"Agent email audit","prompt":"Can you pull up the full folder structure for my Mermail mailbox? I'm setting up a new AI agent and need to know what folders are available before configuring it."}],"resultDescription":"Returns a JSON array of folder objects, each containing an 'id' (e.g. 'inbox') and a 'name' (e.g. 'Inbox') representing the folders available within the specified mailbox.","failureModes":["Invalid or non-existent mailboxId returns an error or empty result","Authentication failure if the agent lacks credentials for the mailbox","Network timeout if the Mermail API is unavailable","Malformed mailboxId path parameter causes a 400-style error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to discover or enumerate the folder structure of a Mermail mailbox before reading, sorting, or routing messages. It is the appropriate first call before fetching messages from a specific folder.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:46:47.132Z","isFirstParty":false,"canonicalSlug":"mermail-mailbox-folders-list-e99febff"}