Back to Browse
Provision Inbox Lease (inbox.withzero.xyz)
Provision Inbox Lease (inbox.withzero.xyz) is a paid API for AI agents from inbox.withzero.xyz, paid per call via MPP, metered — billed by usage, status unknown (last checked 2026-09-15, last successful call 2026-07-29).
Creates or extends a free ~6-month durable inbox lease for the calling wallet, enabling the agent to publish, drain, and manage events.
PriceMeteredbilled by usage
Success100%
StatusUnknown
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 JSON object with the wallet owner address, the ISO timestamp the lease expires (expiresAt), max stored messages allowed, message TTL in days, and the number of times the lease has been extended (lifetimeTopups).
Example use cases
Example prompt
“Set up a durable inbox for my wallet so I can start publishing and draining events — provision the lease and tell me when it expires.”
Technical details
Endpoint
POSThttps://inbox.withzero.xyz/api/v1/inboxesWhen to prefer
Use this endpoint first, before any other inbox.withzero.xyz operation. It must be called to initialize the inbox lease tied to a wallet before publishing events, draining the inbox, or subscribing to topics. Re-call it to extend the lease before expiry rather than creating a new inbox.
Side effects
- Invalid or missing signed proof credential — 401 Unauthorized
- Wallet signature verification failure — authentication rejected
- Malformed request body — 400 Bad Request
- Server-side provisioning error — 500 Internal Server Error
- Lease already at maximum extension count — quota exceeded
Input
{}Schema · Request body
{
"type": "object"
}Output
{
"owner": "0x9cc42f3d9245b867acccd630b43f906c1665b176",
"expiresAt": "2027-12-02T22:50:27.793Z",
"maxMessages": 10000,
"lifetimeTopups": 2,
"messageTtlDays": 30
}Schema · Response
| Field | Type | Description |
|---|---|---|
| ownerrequired | string | Your wallet address; the inbox is keyed to it. |
| expiresAtrequired | string | ISO timestamp the lease is active until. |
| maxMessagesrequired | number | Maximum stored (unexpired) messages. |
| lifetimeTopupsrequired | number | Number of times this lease has been extended. |
| messageTtlDaysrequired | number | How long delivered messages are retained. |
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"