{"uid":"cap_StMqei9VbhierCC7oAoPC","slug":"agentmail-inbox-creation-via-x402-orthogonal-com-bd84d1d9","name":"AgentMail Inbox Creation via x402.orthogonal.com","description":"Create a new email inbox. Inboxes cost $2/month. Inboxes with no API activity for 30+ days are automatically deleted. Any request using the inbox resets the inactivity timer. Returns an inbox_id in email format (e.g., myagent@agentmail.to) used for all subsequent operations. If username is omitted, a random one is generated.","url":"https://x402.orthogonal.com/agentmail/v0/inboxes","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"domain":{"type":"string","description":"Email domain. Must be a verified custom domain. Defaults to agentmail.to."},"username":{"type":"string","description":"Local part of the email address (e.g., myagent becomes myagent@agentmail.to). Randomly generated if omitted."},"client_id":{"type":"string","description":"Your own identifier to associate with this inbox."},"display_name":{"type":"string","description":"Human-readable name shown in the From header (e.g., My Agent <myagent@agentmail.to>)."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"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":{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kV7ZvMSFjDZIscZKJbK3k","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a new email inbox for an AI agent, returning a unique inbox_id email address (e.g., myagent@agentmail.to) for subsequent email operations.","exampleAgentPrompt":"Create a new AgentMail email inbox with the username 'supportbot' and display name 'Support Bot' so my agent can start receiving emails.","exampleUseCases":[{"title":"Support inbox for an agent fleet","prompt":"Set up a new email inbox called 'helpdesk' with the display name 'Help Desk Agent' so my customer support agent can receive and respond to user emails."},{"title":"Ephemeral inbox for a one-off task","prompt":"Create a randomly named agentmail.to inbox for my agent to use during this research task — I don't need a specific username, just generate one."},{"title":"Branded inbox for a named assistant","prompt":"Provision an email inbox with username 'aria' and display name 'Aria from Acme' on agentmail.to so my sales assistant agent can send outreach emails with a professional identity."}],"resultDescription":"Returns an inbox_id in email format (e.g., myagent@agentmail.to) that serves as the identifier for all subsequent inbox operations such as reading, sending, or deleting emails. The inbox is active immediately and auto-deletes after 30 days of inactivity.","failureModes":["Invalid or unverified custom domain — only verified custom domains are accepted; defaults to agentmail.to if omitted","Username collision — if a requested username already exists, the request may fail or return an error","Payment failure — the $2 USDC charge via x402 may fail if the wallet lacks sufficient funds","Malformed input — invalid characters in username or display_name may cause a 400 error","Inactivity deletion — inbox is silently deleted if no API activity occurs for 30+ days"],"whenToPreferThis":"Use this endpoint when an AI agent needs a real, addressable email inbox to send or receive messages as part of an automated workflow. It is especially suited for agents that need persistent email identities, customer-facing communication inboxes, or ephemeral addresses for task-scoped interactions. Prefer this over generic email APIs when you need agent-native inbox lifecycle management with automatic cleanup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:12:37.877Z","isFirstParty":false}