---
title: "API Reference"
account: agentmail-to
slug: agentmail-to
---

# API Reference

Email: create inboxes, send and read messages, threads, drafts, webhooks and domains for agents

- Operations: 208
- Versions: 42 (latest `bb124483eb34`)
- Source: https://docs.agentmail.to/openapi.json
- OpenAPI document: https://skmtc.dev/agentmail-to/apis/agentmail-to/revisions/bb124483eb34?raw

## Get started

### Sign up

#### Humans

1. Create an account in the [AgentMail Console](https://console.agentmail.to).
2. Generate an API key from the dashboard.
3. Send the key as a bearer token on every request.

- No credit card
- Email check not stated
- Phone number not stated

Sources: [AgentMail quickstart](https://www.agentmail.to/docs/quickstart) (checked 2026-11-06), [Agent onboarding](https://docs.agentmail.to/agent-onboarding) (checked 2026-11-06)

#### Agents (agentic score 2/3)

1. Sign up with [POST /v0/agent/sign-up](https://skmtc.dev/agentmail-to/apis/agentmail-to/docs/v0/agent/sign-up/post), giving a username and your human's email address. The response holds an API key, an inbox ID and an organization ID.
2. Human: Read the 6-digit code that AgentMail emails you, and give it to the agent.
3. Send the code to [POST /v0/agent/verify](https://skmtc.dev/agentmail-to/apis/agentmail-to/docs/v0/agent/verify/post). The account moves to the Free plan.

- Agents can sign up
- Email code sent to a human
- No credit card
- Before verifying: 1 inbox, 10 emails a day, to the human only
- No human email: receive-only until a human is attached
- Phone number not stated

Sources: [AgentMail quickstart](https://www.agentmail.to/docs/quickstart) (checked 2026-11-06), [Agent onboarding](https://docs.agentmail.to/agent-onboarding) (checked 2026-11-06), [Why can my agent only email its human?](https://docs.agentmail.to/knowledge-base/agent-sign-up-limits) (checked 2026-11-06)

### Auth

- Method: Bearer token: an API key that starts with am_
- Get a key: From [POST /v0/agent/sign-up](https://skmtc.dev/agentmail-to/apis/agentmail-to/docs/v0/agent/sign-up/post), or in the [AgentMail Console](https://console.agentmail.to)
- Schema: Matches the docs: Bearer (HTTP bearer)

Sources: [Agent onboarding](https://docs.agentmail.to/agent-onboarding) (checked 2026-11-06), [AgentMail quickstart](https://www.agentmail.to/docs/quickstart) (checked 2026-11-06)

### Pricing

- Free: $0: 3 inboxes, 3,000 emails a month, 1 custom domain, no credit card
- Developer: $20 a month: 10 inboxes, 10,000 emails a month, 10 custom domains
- Startup: $200 a month: 150 inboxes, 150 custom domains
- Enterprise: Custom pricing
- Paying as an agent: An agent can pay per request, with no API key or subscription, through [x402](https://docs.agentmail.to/integrations/x402) (USDC on Polygon, Base or Solana) or [MPP](https://docs.agentmail.to/integrations/mpp)

Sources: [AgentMail pricing](https://www.agentmail.to/pricing) (checked 2026-11-06), [x402](https://docs.agentmail.to/integrations/x402) (checked 2026-11-06), [MPP](https://docs.agentmail.to/integrations/mpp) (checked 2026-11-06), [How do I upgrade, downgrade, or cancel my plan?](https://docs.agentmail.to/knowledge-base/change-plan-billing) (checked 2026-11-06)

## Operations

208 in total, by tag:

- agent (3)
- inboxes > files (5)
- inboxes (7)
- inboxes > threads (6)
- inboxes > messages (15)
- inboxes > drafts (7)
- inboxes > webhooks (7)
- inboxes > webhooks > polling (4)
- inboxes > lists (4)
- inboxes > forwarding (3)
- inboxes > metrics (3)
- inboxes > events (1)
- inboxes > api-keys (4)
- inboxes > accounts (2)
- inboxes > calendar (10)
- threads (6)
- drafts (3)
- webhooks (7)
- webhooks > polling (4)
- domains (8)
- lists (4)
- forwarding (5)
- metrics (3)
- api-keys (5)
- apps (5)
- accounts (3)
- pods (4)
- pods > inboxes (6)
- pods > threads (6)
- pods > drafts (3)
- pods > webhooks (7)
- pods > webhooks > polling (4)
- pods > domains (7)
- pods > lists (4)
- pods > forwarding (3)
- pods > metrics (3)
- pods > api-keys (4)
- pods > accounts (2)
- organizations (3)
- auth (1)
- Other (17)

Every operation, with a link to its markdown: https://skmtc.dev/agentmail-to/apis/agentmail-to/llms.txt