{"uid":"cap_144VngVsL_i85Z3uSPjb5","slug":"payweave-mail-update-inbox-settings-7fbf4dd6","name":"PayWeave Mail – Update Inbox Settings","description":"Disposable email inboxes for agents — create, receive, read, and send. Pay per call.","url":"https://mail.payweave.services/inboxes/%7Bslug%7D/update","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"webhook_url":{"type":"string"},"display_name":{"type":"string"}}},"responseSchema":{"type":"object","required":["slug","webhook_url","display_name"],"properties":{"slug":{"type":"string"},"webhook_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"display_name":{"type":["string","null"]},"webhook_secret":{"type":"string","description":"Returned once when a new webhook URL is set. Save it to verify HMAC signatures."}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","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":"free","summary":"Free","primary":{"kind":"free","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_jJIkS4tLlhZ-xujKfYJP6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Updates the webhook URL and/or display name for an existing disposable email inbox identified by its slug.","exampleAgentPrompt":"Update my PayWeave Mail inbox 'agent-007' to forward incoming emails to https://myserver.example.com/hooks/mail, and set its display name to 'Agent Inbox'.","exampleUseCases":null,"resultDescription":"Returns the updated inbox object including the slug, the new webhook URL, display name, and — if the webhook URL was newly set or changed — a one-time webhook_secret string for HMAC signature verification that must be saved immediately.","failureModes":["Inbox slug not found — 404 if the slug does not correspond to an existing inbox","Invalid webhook URL format — 400 if webhook_url is not a valid URI","Payment required — 402 if x402 payment header is missing or insufficient","Webhook secret only returned once — if caller doesn't capture it at response time, it cannot be retrieved again","Empty body — if neither field is provided, update may be a no-op or return 400"],"whenToPreferThis":"Use this endpoint when you need to attach or change a webhook notification URL on an already-created disposable inbox, or when you want to set a human-readable display name for an existing inbox. Choose this over inbox creation if the inbox already exists and you only need to reconfigure its settings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:50:05.652Z","isFirstParty":false}