{"uid":"cap_jfVVJxOGenQeeZCndou5e","slug":"agentmail-inboxes-2590e556","name":"AgentMail Create Inbox","description":"Create Inbox","url":"https://mpp.api.agentmail.to/v0/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":"settled","requiresHandshake":false,"reviewCount":2,"rating":{"score":"0.83","successRate":"0.70","reviews":2,"stars":"4.3","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"$2/call","primary":{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_OcY6woAh8aSNzFPK0DeIx","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":"Creates a new email inbox for an AI agent with a specified or auto-generated username and domain","exampleAgentPrompt":"Set up a new AgentMail inbox with the username 'support-bot' on agentmail.to with the display name 'Support Bot'.","exampleUseCases":null,"resultDescription":"Returns the newly created inbox object including its inbox_id, pod_id, display_name, client_id, and the timestamps for when it was created and last updated. The inbox_id can be used to send emails, retrieve threads, and manage the inbox going forward.","failureModes":["Domain not verified — returns error if the specified domain is not a verified domain on the account","Duplicate username — returns error if the username already exists on the specified domain","Authentication failure — returns 401 if the Bearer token is missing or invalid","Invalid domain format — returns error if domain string is malformed","Missing required fields — though most fields are optional, malformed JSON body may return 400"],"whenToPreferThis":"Use this endpoint when you need to programmatically provision a new email inbox for an AI agent, bot, or automated workflow. Ideal for multi-agent systems where each agent needs its own unique email identity. Prefer this over manual inbox setup when creating inboxes at scale or when inbox creation is part of an automated onboarding or agent-spawning workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":14,"lastUsedAt":"2026-08-27T08:10:35.795Z","lastSuccessfullyRanAt":"2026-08-27T08:10:35.795Z","lastHealthCheckAt":"2026-10-10T00:48:12.713Z","isFirstParty":false,"canonicalSlug":"agentmail-inboxes-2590e556"}