# PayWeave Mail – Update Inbox Settings

> PayWeave Mail – Update Inbox Settings is a free API for AI agents from mail.payweave.services, callable via x402, Free, status unknown (last checked 2026-09-13).

Updates the webhook URL and/or display name for an existing disposable email inbox identified by its slug.

## Facts

- Endpoint: POST https://mail.payweave.services/inboxes/%7Bslug%7D/update
- Price: Free
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/payweave-mail-update-inbox-settings-7fbf4dd6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_144VngVsL_i85Z3uSPjb5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability payweave-mail-update-inbox-settings-7fbf4dd6 -d '<json body>'
```

Example prompt: 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'.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Disposable email inboxes for agents — create, receive, read, and send. Pay per call.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "webhook_url": {
   "type": "string"
  },
  "display_name": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/payweave-mail-update-inbox-settings-7fbf4dd6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mail.payweave.services](https://www.zero.xyz/host/mail.payweave.services/llms.txt)