{"uid":"cap__Ap60vOC8hAv9zlpjmLgb","slug":"machine-inbox-create-7-day-private-email-inbox-835a2e30","name":"Machine Inbox — Create 7-Day Private Email Inbox","description":"Pay-per-use email inboxes for software agents. Pay $2.00 through Stripe Machine Payments Protocol or x402 USDC, receive mail, and reply over HTTP.","url":"https://machineinbox.com/api/v1/inboxes","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","additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"inbox":{"id":"uuid","address":"m_example@in.machineinbox.com","expiresAt":"2026-08-25T12:00:00.000Z"},"token":"mi_live_..."}},"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_-9xm7Bh4xthZC_jkYaYVz","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 private, temporary email inbox that expires after seven days, returning a unique email address and access token for agent use","exampleAgentPrompt":"Spin up a fresh private Machine Inbox email address for me — I need it to last seven days so my agent can receive messages during the workflow.","exampleUseCases":[{"title":"Onboarding verification inbox for agent","prompt":"Create a temporary 7-day email inbox so my onboarding bot can receive confirmation emails and replies from new users during the sign-up process."},{"title":"Support inbox for an agent fleet","prompt":"I need a private email address provisioned for my support agent that will last a week — it needs to receive and read incoming customer messages autonomously."},{"title":"Automated campaign reply collection","prompt":"Set up a disposable inbox on Machine Inbox that lasts seven days so my outreach agent can collect replies to the campaign emails it sends this week."}],"resultDescription":"Returns a JSON object containing the new inbox's UUID, its full email address (e.g. m_example@in.machineinbox.com), the ISO 8601 expiration timestamp (7 days from creation), and a bearer token (mi_live_...) for authenticating subsequent requests to read or manage the inbox.","failureModes":["Payment failure — insufficient USDC balance or x402 payment not accepted, resulting in 402 Payment Required","Invalid request body — missing required fields returns 400 Bad Request","Service unavailability — upstream email infrastructure down, returns 503","Rate limiting — too many inbox creation requests in a short window, returns 429","Authentication failure — invalid or missing payment credentials"],"whenToPreferThis":"Choose this endpoint when an AI agent needs a real, persistent email address that can receive multiple messages over an extended period (up to 7 days) rather than a one-time verification code. Prefer this over the 1-hour verification inbox when your workflow spans more than an hour or requires ongoing email communication. Ideal for agents managing multi-day workflows, onboarding sequences, or any automated process where a stable inbox identity is needed for a week.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T12:35:34.753Z","isFirstParty":false}