{"uid":"cap_yWFHeqBccO-9rdOi9Mvdn","slug":"withzero-inbox-creation-via-zeroclick-2f2cd551","name":"WithZero Inbox Creation via ZeroClick","description":"Provision your inbox — call this FIRST (free, ~6-month lease keyed to your signed wallet; re-call to extend before it expires). Then: publish via POST /api/v1/events, long-poll GET /api/v1/inbox, ack handled events via POST /api/v1/inbox/ack, check the lease via GET /api/v1/inboxes/me. Receive other wallets’ events via POST /api/v1/subscriptions and external webhooks via POST /api/v1/connections. See the API description for the full workflow. 📖 Full guide: https://inbox.withzero.xyz/llms.txt","url":"https://agents.withzero.xyz/api/v1/inbox/inboxes","method":"POST","headers":{},"bodySchema":{"type":"object"},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["owner","expiresAt","messageTtlDays","maxMessages","lifetimeTopups"],"properties":{"owner":{"type":"string","description":"Your wallet address; the inbox is keyed to it."},"expiresAt":{"type":"string","description":"ISO timestamp the lease is active until."},"maxMessages":{"type":"number","description":"Maximum stored (unexpired) messages."},"lifetimeTopups":{"type":"number","description":"Number of times this lease has been extended."},"messageTtlDays":{"type":"number","description":"How long delivered messages are retained."}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.000000","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"unknown_unparsed","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":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"},{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_kLZehd2bxcKh2PelJf9g5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_qTVHKsM6qW0I4nCJn2lMz","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000000","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a new managed inbox for receiving and routing messages, with pay-per-use billing via ZeroClick proxy—no vendor account required.","exampleAgentPrompt":"Create a new inbox called 'project-alpha-notifications' so I can start receiving messages for my new agent deployment—no account setup needed, just provision it now.","exampleUseCases":[{"title":"Support inbox for an agent fleet","prompt":"Set up a new inbox named 'support-queue' so my fleet of agents can start receiving incoming support requests and route them appropriately."},{"title":"Dedicated project communication channel","prompt":"Create an inbox called 'marketing-campaign-2025' for my team's agent to receive all inbound messages related to the campaign without needing a separate vendor account."},{"title":"On-demand inbox for automated workflow","prompt":"Provision a new inbox right now called 'order-confirmations' so my order-processing agent can start receiving confirmation messages from suppliers—pay as you go, no signup."}],"resultDescription":"Returns a newly created inbox resource including its unique inbox ID, configuration details, and endpoint information that agents can use to receive and retrieve messages. The response confirms the inbox is active and ready to accept incoming communications.","failureModes":["Invalid or missing inbox configuration fields returns a 400 error","Duplicate inbox name may return a conflict error if unique names are enforced","Payment or identity issues via ZeroClick proxy may return 402 or 401 errors","Upstream WithZero API unavailability results in 502 or 503 errors","Malformed request body causes validation errors"],"whenToPreferThis":"Choose this endpoint when an agent needs to programmatically create a new inbox on demand without pre-registering a vendor account. It is ideal for ephemeral or project-scoped inboxes, agent fleet orchestration, or any workflow where inbox provisioning must be automated and billed transparently per use via USDC. Prefer this over managed SaaS inbox products when you need zero-setup, pay-as-you-go inbox creation within an autonomous agent workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":4,"lastUsedAt":"2026-07-29T00:20:36.173Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:44:56.289Z","isFirstParty":true}