{"uid":"cap_V0Bk2LKvZwYCp2d_kNcJn","slug":"mermail-mailbox-custom-labels-list-97548e89","name":"Mermail Mailbox Custom Labels 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/custom-labels?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":"label_1","name":"Follow up"}]},"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_jymHZVxAQEyBmm7fJ7-17","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 all custom labels defined for a specific Mermail mailbox, returning their IDs and names.","exampleAgentPrompt":"What custom labels are set up in my Mermail mailbox mb_abc123? I need the list of label names and IDs so I can tag incoming messages correctly.","exampleUseCases":[{"title":"Tag routing for sales leads","prompt":"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?"},{"title":"Customer support label audit","prompt":"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."},{"title":"Pre-labeling workflow setup","prompt":"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."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:43:25.403Z","isFirstParty":false,"canonicalSlug":"mermail-mailbox-custom-labels-list-97548e89"}