# ai-mail.sh Monthly Inbox

> ai-mail.sh Monthly Inbox is a paid API for AI agents from ai-mail.sh, paid per call via x402, $1/call, status unknown (last checked 2026-10-11).

Creates a new receive-only @ai-mail.sh email inbox for an AI agent, valid for 30 days and accepting up to 500 incoming emails, with verification codes and links extracted automatically.

## Facts

- Endpoint: GET https://ai-mail.sh/inbox/month?utm_source=zero.xyz
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ai-mail-sh-monthly-inbox-a0ca0115
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GWvGoClyebqPr9D8JL67R

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 ai-mail-sh-monthly-inbox-a0ca0115
```

Example prompt: Set up a new ai-mail.sh inbox for me that lasts 30 days and can handle up to 500 emails — I need it to automatically pull out any verification codes or login links that arrive.

## When to prefer this

Choose this endpoint over the 24-hour sibling when your agent workflow spans days or weeks, or when you expect more than 10 incoming emails. It is ideal for automated account registration pipelines, long-running bot workflows, or staging/test environments where a persistent, high-capacity disposable inbox is needed. The automatic extraction of verification codes and links makes it especially suitable when the agent must act on OTPs or confirmation URLs without parsing raw email bodies.

## Known failure modes

- Payment failure — the $1 USDC x402 payment is not completed, resulting in a 402 Payment Required response and no inbox being created
- Rate limiting — too many inbox creation requests in a short window may be rejected
- Service unavailability — the ai-mail.sh service is down or unreachable, returning a 5xx error
- Inbox capacity exceeded — if 500 emails are received before the 30-day period ends, additional emails may be rejected or dropped
- Inbox expiry — attempting to retrieve emails after 30 days results in a not-found or expired error

## How this service works

New @ai-mail.sh email inbox for an AI agent: 30 days, up to 500 incoming emails. Receive-only; codes and verification links extracted. Docs: https://ai-mail.sh/llms.txt

## Output

Returns a newly provisioned @ai-mail.sh email address valid for 30 days, accepting up to 500 incoming messages, along with inbox credentials or access token. As emails arrive, verification codes and clickable verification links are automatically extracted and surfaced, so the agent does not need to parse raw email content.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ai-mail-sh-monthly-inbox-a0ca0115/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ai-mail.sh](https://www.zero.xyz/host/ai-mail.sh/llms.txt)