{"uid":"cap_57Kz5knPH55PC19dRMs5b","slug":"agentmail-inboxes-09b9d956","name":"AgentMail List Inboxes","description":"List Inboxes","url":"https://mpp.api.agentmail.to/v0/inboxes?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","title":"Limit","description":"Limit of number of items returned."},"ascending":{"type":"boolean","title":"Ascending","description":"Sort in ascending temporal order."},"page_token":{"type":"string","title":"PageToken","description":"Page token for pagination."}}},"responseSchema":{"type":"object","title":"ListInboxesResponse","required":["count","inboxes"],"properties":{"count":{"type":"integer","title":"Count","description":"Number of items returned."},"limit":{"type":"integer","title":"Limit","description":"Limit of number of items returned."},"inboxes":{"type":"array","items":{"type":"object","title":"Inbox","required":["pod_id","inbox_id","updated_at","created_at"],"properties":{"pod_id":{"type":"string","title":"PodId","description":"ID of pod."},"inbox_id":{"type":"string","title":"InboxId","description":"The ID of the inbox."},"client_id":{"type":"string","title":"ClientId","description":"Client ID of inbox."},"created_at":{"type":"string","format":"date-time","description":"Time at which inbox was created."},"updated_at":{"type":"string","format":"date-time","description":"Time at which inbox was last updated."},"display_name":{"type":"string","title":"DisplayName","description":"Display name: `Display Name <username@domain.com>`."}}},"description":"Ordered by `created_at` descending."},"next_page_token":{"type":"string","title":"PageToken","description":"Page token for pagination."}}},"example":null,"exampleRequest":null,"tags":["email","inboxes","domains","drafts","threads","webhooks","messaging","ai","social"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.50","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_gQS7k_ae4M5nRZgGEKJ6P","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Retrieves a paginated list of all email inboxes associated with the authenticated account, including inbox IDs, pod IDs, display names, and timestamps.","exampleAgentPrompt":"Show me all the AgentMail inboxes in my account — list up to 20, sorted oldest first.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing a count of inboxes returned, an array of inbox objects (each with inbox_id, pod_id, optional client_id, display_name, created_at, updated_at), and an optional next_page_token for fetching additional pages.","failureModes":["401 Unauthorized if Authorization Bearer token is missing or invalid","Empty inboxes array if no inboxes have been created yet","Malformed page_token causing pagination errors","Rate limiting or server errors returning 429 or 5xx responses"],"whenToPreferThis":"Use this endpoint when you need to discover or enumerate all email inboxes provisioned under an AgentMail account — for example, before reading threads, managing drafts, or routing messages to a specific inbox. Prefer this over brand-level metadata calls when you need actual inbox IDs and display names for downstream operations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-05-19T12:24:24.777Z","lastSuccessfullyRanAt":"2026-05-12T20:11:56.894Z","lastHealthCheckAt":"2026-10-11T06:36:00.647Z","isFirstParty":false,"canonicalSlug":"agentmail-inboxes-09b9d956"}