{"uid":"cap_ZJNQ_O4PZ8P8byOOyWNT0","slug":"agentmail-inboxes-095812b7","name":"AgentMail List Inboxes","description":"List Inboxes","url":"https://mpp.api.agentmail.to/v0/pods/:pod_id/inboxes?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["pod_id"],"properties":{"limit":{"type":"integer","title":"Limit","description":"Limit of number of items returned."},"pod_id":{"type":"string","title":"PodId","description":"ID of pod."},"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":"unknown","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":"free","summary":"Free","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Lists all email inboxes belonging to a specific AgentMail pod, with pagination support","exampleAgentPrompt":"Show me all the email inboxes under my AgentMail pod 'pod_abc123', sorted from oldest to newest.","exampleUseCases":[{"title":"Audit all agent email addresses","prompt":"List every email inbox I have set up across my agent pod and tell me which ones were created most recently—I need to make sure everything's properly configured."},{"title":"Discover inbox IDs for mass operations","prompt":"Pull up all the inboxes in my pod with their IDs so I can figure out which ones I need to run bulk email tasks on."},{"title":"Monitor inbox count and creation dates","prompt":"Show me how many total email inboxes are associated with my pod and when each one was added, so I can track our agent's email growth over time."}],"resultDescription":"Returns a paginated list of inbox objects for the specified pod, each containing inbox_id, pod_id, display_name (formatted as 'Name <email@domain.com>'), client_id, created_at, updated_at timestamps, plus a total count and optional next_page_token for further pagination.","failureModes":["pod_id not found — 404 error if the pod does not exist or does not belong to the authenticated user","missing or invalid Authorization header — 401 unauthorized","invalid page_token — may return 400 or empty result set","invalid limit value (e.g. negative number) — 400 bad request","empty pod with no inboxes — returns count: 0 and empty inboxes array"],"whenToPreferThis":"Use this endpoint when you need to enumerate or audit all email inboxes associated with a specific AgentMail pod, especially before performing operations on individual inboxes or when you need to discover inbox IDs dynamically. Prefer this over manually tracking inbox IDs when working with multiple agent inboxes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:46:51.258Z","isFirstParty":false,"canonicalSlug":"agentmail-inboxes-09b9d956"}