{"uid":"cap_FG8PG51MtrazSAVH49FlK","slug":"mekler-ai-create-private-temporary-email-inbox-f31bca87","name":"Mekler AI – Create Private Temporary Email Inbox","description":"Create a private receive-only email inbox for an agent. Read incoming confirmation mail and attachments for 24 hours, up to 25 messages of 128 KiB each, and optionally receive signed arrival webhooks. Creation costs 0.05 USDC; capability-authorized reads and deletion are free. No outbound email, permanent address or guarantee that websites accept the address.","url":"https://api.mekler.ai/v1/email/inboxes/create-private-inbox?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"access_key":{"type":"string","pattern":"^[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"request_id":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,64}$"},"webhook_url":{"type":"string","format":"uri","maxLength":2048}}},"responseSchema":{"type":"json","example":{"limits":{"messages":25,"raw_message_bytes":131072},"status":"ok","address":"ed157de6233b2dbbb69d46c26189a7c5@inbox.mekler.ai","inbox_id":"ed157de6233b2dbbb69d46c26189a7c5","created_at":1792252800,"expires_at":1792339200}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yei3yaM3g35GfplJ9U5BX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a disposable, temporary email inbox address on inbox.mekler.ai that can receive up to 25 messages, with optional webhook delivery notifications.","exampleAgentPrompt":"Create a private temporary email inbox for me so I can receive a verification email — notify my server at https://hooks.example.com/email-events when a message arrives.","exampleUseCases":[{"title":"Agent sign-up burner inbox","prompt":"I need a throwaway email address my agent can use to register for a third-party service — spin up a private inbox and forward any incoming messages to https://hooks.myagent.io/inbox so I get notified instantly."},{"title":"Automated testing email capture","prompt":"Set up a temporary email inbox I can use in my integration tests to capture confirmation emails — I'll poll it myself so no webhook needed, just give me the address and inbox ID."},{"title":"Single-use verification address","prompt":"Create a disposable inbox address for me that I can hand to a newsletter to get their confirmation link — I just need the email address and to know when it expires."}],"resultDescription":"Returns a JSON object containing the newly created inbox email address (e.g. ed157de6233b2dbbb69d46c26199a7c5@inbox.mekler.ai), a unique inbox_id, creation and expiry Unix timestamps, and limits (max 25 messages, 128 KB raw message storage). Status field confirms successful provisioning.","failureModes":["Invalid or missing access_key format returns authentication error","Malformed webhook_url (non-URI) causes request rejection","Duplicate request_id within idempotency window may return cached or conflict response","Payment failure via x402 (insufficient USDC balance) results in 402 Payment Required","Service unavailability returns 5xx error; inbox not created"],"whenToPreferThis":"Choose this endpoint when an AI agent or automated workflow needs a real, deliverable temporary email address without sharing a permanent identity — especially useful for receiving one-time verification codes, sign-up confirmations, or test emails. Prefer it over permanent email creation when the inbox only needs to live for ~24 hours. The x402 pay-per-call model (no API key required) makes it ideal for agents that run on-demand rather than continuously.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:30:08.384Z","isFirstParty":false,"canonicalSlug":"mekler-ai-create-private-temporary-email-inbox-f31bca87"}