{"uid":"cap_GC6Fg6Wtr9fBcw2mJOXp0","slug":"agentmail-create-inbox-52a83675","name":"AgentMail Create Inbox","description":"Give an AI agent a credit account. Set a limit and a spending policy, and the agent makes approved, metered purchases from providers that accept Vaaya.","url":"https://vaaya.ai/api/run/agentmail/create_inbox","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"domain":{"type":"string"},"username":{"type":"string"},"display_name":{"type":"string"}},"additionalProperties":true},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"pathParams":{"type":"object"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_GtQ1X70j1zl5ZYFjpquNM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"2","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a new email inbox with a specified username, domain, and display name for use by AI agents","exampleAgentPrompt":"Create a new email inbox for my agent using the username 'sales-bot', the domain 'agentmail.io', and the display name 'Sales Assistant'.","exampleUseCases":[{"title":"Outreach agent email setup","prompt":"Set up a new inbox for my outreach agent — use the username 'outreach', the domain 'agentmail.io', and the display name 'Growth Team'."},{"title":"Support inbox for an agent fleet","prompt":"Create a dedicated email inbox for my customer support agent with username 'support-agent', domain 'agentmail.io', and display name 'Support Bot'."},{"title":"Product demo agent mailbox","prompt":"I need an email inbox for my product demo agent — username should be 'demo', domain 'agentmail.io', and display name 'Demo Assistant'."}],"resultDescription":"Returns a confirmation object containing the created inbox details, including the assigned email address, inbox ID, username, domain, and display name, which the agent can then use to send or receive email via subsequent API calls.","failureModes":["Username already taken on the specified domain — returns a conflict or duplicate error","Invalid domain specified — returns a validation error if the domain is not supported or registered","Malformed request body — returns a 400 error if required fields (username, domain) are missing","Payment failure — $2 USDC charge may fail if wallet balance is insufficient or x402 payment is rejected","Rate limiting — too many inbox creation requests in a short window may result in throttling"],"whenToPreferThis":"Choose this endpoint when an AI agent needs its own persistent email address to send outreach, receive replies, or participate in email-based workflows. It is the right call when you want a real, addressable inbox rather than a transient send-only address, and when you need the inbox provisioned programmatically without manual account creation or API key setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:43:09.776Z","isFirstParty":false}