{"uid":"cap_UcP75Qs5qxeYC0tgGC88X","slug":"agentmail-inboxes-48f7c07a","name":"AgentMail Create Inbox","description":"Create Inbox","url":"https://mpp.api.agentmail.to/v0/pods/:pod_id/inboxes?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"CreateInboxRequest","properties":{"domain":{"type":"string","description":"Domain of address. Must be verified domain. Defaults to `agentmail.to`."},"username":{"type":"string","description":"Username of address. Randomly generated if not specified."},"client_id":{"type":"string","title":"ClientId","description":"Client ID of inbox."},"display_name":{"type":"string","title":"DisplayName","description":"Display name: `Display Name <username@domain.com>`."}}},"responseSchema":{"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>`."}}},"example":null,"exampleRequest":null,"tags":["email","inboxes","domains","drafts","threads","webhooks","messaging","ai","social"],"displayCostAmount":"2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":null,"accepted":[]},"paymentMethods":[],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Creates a new email inbox for an AI agent within a specified pod, optionally with a custom username, domain, and display name.","exampleAgentPrompt":"Create a new AgentMail inbox in pod 'pod_abc123' with the username 'support-bot' on the agentmail.to domain and display name 'Support Bot'.","exampleUseCases":null,"resultDescription":"Returns an Inbox object with the new inbox_id, pod_id, optional client_id and display_name, and timestamps for when the inbox was created and last updated. The email address is constructed as username@domain.","failureModes":["Invalid or unverified domain — only verified domains are accepted; agentmail.to is the default","Missing or invalid pod_id path parameter — 404 or 400 error","Unauthorized request if Bearer token is missing or invalid — 401 error","Username already taken on the specified domain — conflict error","Malformed request body — 422 validation error"],"whenToPreferThis":"Use this endpoint when you need to provision a new email inbox for an AI agent within an existing AgentMail pod. It is the right choice for dynamically creating agent-specific email addresses, especially when you need a custom username, a verified custom domain, or a human-readable display name. Prefer this over alternatives when building multi-agent systems that require isolated inboxes per agent or per task.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-06-20T00:03:10.508Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:45:43.457Z","isFirstParty":false,"canonicalSlug":"agentmail-inboxes-2590e556"}