# AgentMail Create Inbox

> AgentMail Create Inbox is a paid API for AI agents from AgentMail at mpp.api.agentmail.to, paid per call via MPP, $2/call, status unknown (last checked 2026-10-10, last successful call 2026-08-27).

Creates a new email inbox for an AI agent with a specified or auto-generated username and domain

## Facts

- Endpoint: POST https://mpp.api.agentmail.to/v0/inboxes?utm_source=zero.xyz
- Price: $2/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-10
- Last successful call: 2026-08-27
- Success rate: 70% of calls made through Zero
- Rating: 4.3 / 5 from 2 reviews
- Activations on Zero: 14
- Provider: AgentMail
- Docs: https://docs.agentmail.to
- Website: https://agentmail.to
- Tags: email, inboxes, domains, drafts, threads, webhooks, messaging, ai, social
- Canonical page: https://www.zero.xyz/c/agentmail-inboxes-2590e556
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jfVVJxOGenQeeZCndou5e

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-inboxes-2590e556 -d '<json body>'
```

Example prompt: Set up a new AgentMail inbox with the username 'support-bot' on agentmail.to with the display name 'Support Bot'.

## When to prefer this

Use this endpoint when you need to programmatically provision a new email inbox for an AI agent, bot, or automated workflow. Ideal for multi-agent systems where each agent needs its own unique email identity. Prefer this over manual inbox setup when creating inboxes at scale or when inbox creation is part of an automated onboarding or agent-spawning workflow.

## Known failure modes

- Domain not verified — returns error if the specified domain is not a verified domain on the account
- Duplicate username — returns error if the username already exists on the specified domain
- Authentication failure — returns 401 if the Bearer token is missing or invalid
- Invalid domain format — returns error if domain string is malformed
- Missing required fields — though most fields are optional, malformed JSON body may return 400

## How this service works

Create Inbox

## Output

Returns the newly created inbox object including its inbox_id, pod_id, display_name, client_id, and the timestamps for when it was created and last updated. The inbox_id can be used to send emails, retrieve threads, and manage the inbox going forward.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "CreateInboxRequest",
 "properties": {
  "domain": {
   "type": "string",
   "description": "Domain of address. Must be verified domain. Defaults to `agentmail.to`."
  },
  "username": {
   "type": "string",
   "description": "Username of address. Randomly generated if not specified."
  },
  "client_id": {
   "type": "string",
   "title": "ClientId",
   "description": "Client ID of inbox."
  },
  "display_name": {
   "type": "string",
   "title": "DisplayName",
   "description": "Display name: `Display Name <username@domain.com>`."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "Inbox",
 "required": [
  "pod_id",
  "inbox_id",
  "updated_at",
  "created_at"
 ],
 "properties": {
  "pod_id": {
   "type": "string",
   "title": "PodId",
   "description": "ID of pod."
  },
  "inbox_id": {
   "type": "string",
   "title": "InboxId",
   "description": "The ID of the inbox."
  },
  "client_id": {
   "type": "string",
   "title": "ClientId",
   "description": "Client ID of inbox."
  },
  "created_at": {
   "type": "string",
   "format": "date-time",
   "description": "Time at which inbox was created."
  },
  "updated_at": {
   "type": "string",
   "format": "date-time",
   "description": "Time at which inbox was last updated."
  },
  "display_name": {
   "type": "string",
   "title": "DisplayName",
   "description": "Display name: `Display Name <username@domain.com>`."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentmail-inboxes-2590e556/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mpp.api.agentmail.to](https://www.zero.xyz/host/mpp.api.agentmail.to/llms.txt)