{"uid":"cap_3gDU1km9j1NoQ1T-AzA1R","slug":"payweave-relay-create-durable-webhook-inbox-25bbf109","name":"PayWeave Relay – Create Durable Webhook Inbox","description":"Durable webhook inboxes for agents. Receive callbacks and approvals without holding a connection open.","url":"https://relay.payweave.services/inboxes","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"label":{"type":"string","description":"Short purpose label, e.g. \"stripe-payment-confirmations\". Returned on read/info/list."},"ttlDays":{"type":"integer","description":"Inbox lifetime in days (1-30, default 1). Priced in tiers: <=1d, <=7d, <=30d."},"metadata":{"type":"object","description":"Arbitrary small JSON object describing the inbox purpose (<=2048 bytes serialized). Returned on read/info/list."}}},"responseSchema":{"type":"object","required":["id","callbackUrl","expiresAt","capacity","ttlDays"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"ttlDays":{"type":"number"},"capacity":{"type":"number"},"metadata":{"type":"object","additionalProperties":{}},"expiresAt":{"type":"number"},"callbackUrl":{"type":"string"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.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_JV46-N34ZocWv4H8k4btA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a durable, time-bounded webhook inbox with a stable callback URL so agents can receive async callbacks and approvals without holding an open connection.","exampleAgentPrompt":"Create a durable webhook inbox labeled 'stripe-payment-confirmations' that lasts 7 days — I need a stable callback URL my agent can use to receive async payment confirmation events without holding a connection open.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a unique inbox ID, a stable callbackUrl that third parties can POST callbacks to, an expiresAt Unix timestamp, the inbox capacity, ttlDays, an optional label, and any metadata supplied at creation time.","failureModes":["Invalid ttlDays value outside 1-30 range returns a 400 error","metadata payload exceeding 2048 bytes serialized causes a rejection","Payment failure (insufficient USDC balance) returns a 402 response before provisioning","Duplicate label does not guarantee idempotency — a new inbox is always created","Expired or invalid x402 payment header causes authentication failure"],"whenToPreferThis":"Choose this endpoint when your AI agent or automated workflow needs to receive asynchronous callbacks, webhooks, or approval signals from external services (e.g. payment processors, OAuth flows, human-in-the-loop approvals) without maintaining a persistent open connection. Prefer it over polling or long-lived sockets when you need a guaranteed-durable, time-bounded, addressable callback URL provisioned on demand.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T19:23:29.945Z","isFirstParty":false}