{"uid":"cap_z0D0wUgbgkFF4pvFUGes1","slug":"codepulse-api-disposable-mailbox-create-ad7cd0dd","name":"CodePulse API – Disposable Mailbox Create","description":"Generates a temporary disposable inbox address using the free 1secmail.com service.","url":"https://codepulse-api.hahavoid0.workers.dev/mailbox/create","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","properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"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":{"result":{"email":"xdf908234@1secmail.com"},"warnings":[],"supported":true,"confidence":"high","data_as_of":"2026-06","disclaimer":"Informational support only. Not legal, tax, medical, veterinary, or financial advice. Verify with the cited official source or a qualified professional before acting."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BO-1M_FugYR-jRdtZAwhI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a new disposable (temporary) email inbox and returns a fresh throwaway email address instantly.","exampleAgentPrompt":"Create a disposable throwaway email inbox for me right now — I need a working temporary email address I can use for a sign-up form without giving away my real email.","exampleUseCases":[{"title":"Spam-free sign-up inbox","prompt":"I need a temporary email address to sign up for a website that I don't want spamming me — can you create a disposable mailbox I can use right now?"},{"title":"Automated testing email flow","prompt":"I'm testing a user registration flow in my app and need a fresh throwaway inbox for each test run — spin one up for me so I can verify the confirmation email gets sent."},{"title":"Agent workflow burner address","prompt":"My AI agent needs its own temporary email address to receive a verification code during an automated task — please create a disposable inbox it can use immediately."}],"resultDescription":"Returns a JSON object containing a freshly generated disposable email address (e.g. xdf908234@1secmail.com), along with a confidence rating, data freshness timestamp, and a standard informational disclaimer. No credentials or API key required.","failureModes":["Upstream mailbox provider (1secmail) unavailable — may return error or empty result","Malformed request body (wrong bodyType or missing required fields) — likely 400 Bad Request","x402 payment failure (insufficient USDC balance or network issue on Base) — payment-layer rejection before execution","Rate limiting or worker timeout on Cloudflare edge — may return 5xx"],"whenToPreferThis":"Choose this endpoint when you need a programmatic, pay-per-use disposable email address with no API key setup, billing account, or registration required. Ideal for AI agent workflows that need ephemeral inboxes on demand, automated testing pipelines, or privacy-preserving sign-up flows. Prefer this over traditional email APIs (SendGrid, Mailgun) which require account setup and are not designed for throwaway inbox creation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-07-28T16:58:02.448Z","lastSuccessfullyRanAt":"2026-07-28T16:58:02.448Z","lastHealthCheckAt":"2026-09-15T18:34:20.151Z","isFirstParty":false}