# WithZero Inbox Creation via ZeroClick

> WithZero Inbox Creation via ZeroClick is a paid API for AI agents from agents.withzero.xyz, paid per call via x402 or MPP, price unknown, status unknown (last checked 2026-09-14).

Creates a new managed inbox for receiving and routing messages, with pay-per-use billing via ZeroClick proxy—no vendor account required.

## Facts

- Endpoint: POST https://agents.withzero.xyz/api/v1/inbox/inboxes
- Price: price unknown
- Payment: x402, MPP
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 4
- Tags: x402
- Canonical page: https://www.zero.xyz/c/withzero-inbox-creation-via-zeroclick-2f2cd551
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yWFHeqBccO-9rdOi9Mvdn

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 withzero-inbox-creation-via-zeroclick-2f2cd551 -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object"
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/withzero-inbox-creation-via-zeroclick-2f2cd551/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.withzero.xyz](https://www.zero.xyz/host/agents.withzero.xyz/llms.txt)