# agmail 1-Hour Receive-Only Email Inbox

> agmail 1-Hour Receive-Only Email Inbox is a paid API for AI agents from agmail.shveik.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-10).

Creates a temporary, receive-only email inbox valid for 1 hour, returning an address, secret, and inbox ID for use by AI agents.

## Facts

- Endpoint: POST https://agmail.shveik.dev/v1/x402/inbox-1h?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agmail-1-hour-receive-only-email-inbox-cea15954
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AHYKIJazlVXCsDXA0-M2L

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 agmail-1-hour-receive-only-email-inbox-cea15954 -d '<json body>'
```

Example prompt: Create a temporary email inbox called 'mybot42' that lasts one hour — I need the address and secret so my agent can check for incoming emails.

## When to prefer this

Choose this endpoint when your AI agent needs a real, deliverable email address to receive messages (verifications, OTPs, notifications) within a short, bounded time window, and you want to pay per-use in stablecoins via x402/MPP rather than managing a persistent email account or SMTP credentials. Ideal for single-session, ephemeral agent workflows.

## Known failure modes

- Invalid name format (does not match ^[a-zA-Z0-9]([a-zA-Z0-9._-]{1,30})[a-zA-Z0-9]$ pattern) returns 4xx validation error
- Name too short (<3 chars) or too long (>32 chars) rejected
- Payment failure via x402 or MPP returns 402 Payment Required
- Name already taken may return a conflict error
- Service unavailability returns 5xx

## How this service works

Receive-only email inboxes for AI agents, by the hour. Pay in stablecoins with x402 or MPP; one call returns the code or the link.

## Output

Returns a JSON object containing the plan ('1h'), a secret token (agm_…) for authenticating inbox access, the provisioned email address (e.g. acme42@agmail…), a message capacity (50 messages), a unique inbox ID (ib_…), and an ISO 8601 expiry timestamp one hour in the future.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "pattern": "^[a-zA-Z0-9]([a-zA-Z0-9._-]{1,30})[a-zA-Z0-9]$",
   "maxLength": 32,
   "minLength": 3
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "plan": "1h",
  "secret": "agm_01234567…",
  "address": "acme42@agmai…",
  "msg_cap": 50,
  "inbox_id": "ib_012345678…",
  "expires_at": "2026-10-06T1…"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agmail-1-hour-receive-only-email-inbox-cea15954/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agmail.shveik.dev](https://www.zero.xyz/host/agmail.shveik.dev/llms.txt)