# AgentMail Create Inbox

> AgentMail Create Inbox is a paid API for AI agents from vaaya.ai, paid per call via x402, $2/call, status unknown (last checked 2026-09-14).

Creates a new email inbox with a specified username, domain, and display name for use by AI agents

## Facts

- Endpoint: POST https://vaaya.ai/api/run/agentmail/create_inbox
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentmail-create-inbox-52a83675
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GC6Fg6Wtr9fBcw2mJOXp0

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 agentmail-create-inbox-52a83675 -d '<json body>'
```

Example prompt: Create a new email inbox for my agent using the username 'sales-bot', the domain 'agentmail.io', and the display name 'Sales Assistant'.

## When to prefer this

Choose this endpoint when an AI agent needs its own persistent email address to send outreach, receive replies, or participate in email-based workflows. It is the right call when you want a real, addressable inbox rather than a transient send-only address, and when you need the inbox provisioned programmatically without manual account creation or API key setup.

## Known failure modes

- Username already taken on the specified domain — returns a conflict or duplicate error
- Invalid domain specified — returns a validation error if the domain is not supported or registered
- Malformed request body — returns a 400 error if required fields (username, domain) are missing
- Payment failure — $2 USDC charge may fail if wallet balance is insufficient or x402 payment is rejected
- Rate limiting — too many inbox creation requests in a short window may result in throttling

## How this service works

Give an AI agent a credit account. Set a limit and a spending policy, and the agent makes approved, metered purchases from providers that accept Vaaya.

## Output

Returns a confirmation object containing the created inbox details, including the assigned email address, inbox ID, username, domain, and display name, which the agent can then use to send or receive email via subsequent API calls.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "$schema": "http://json-schema.org/draft-07/schema#",
     "properties": {
      "domain": {
       "type": "string"
      },
      "username": {
       "type": "string"
      },
      "display_name": {
       "type": "string"
      }
     },
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    }
   },
   "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/agentmail-create-inbox-52a83675/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vaaya.ai](https://www.zero.xyz/host/vaaya.ai/llms.txt)