Create email inboxes for AI agents within a pod via the AgentMail MPP API.
What it does
This endpoint creates a new email inbox under a specific pod in the AgentMail service. AgentMail provides programmatic email inboxes designed for AI agents — allowing agents to send, receive, reply to, and manage email just like a human would with Gmail. The endpoint is accessed via POST to `/v0/pods/{pod_id}/inboxes` and accepts an optional JSON body specifying username, domain (defaults to agentmail.to), display name, and client ID. On success it returns an Inbox object containing the pod_id, inbox_id, timestamps, and optional display name.
The endpoint is part of a comprehensive AgentMail API exposed over the MPP (Micropayment Protocol) gateway at `mpp.api.agentmail.to`. The full API covers inbox CRUD, message sending/receiving/replying/forwarding, threads, drafts, attachments, custom domains with DNS verification, webhooks for real-time events (received, sent, bounced, etc.), allow/block lists, and metrics. Payment is settled via the Tempo method on chain 4217. The Create Inbox operation has a fixed price of 2 units (currency and decimals are not fully specified in the challenge, so the exact dollar amount is unclear). Many read operations (list, get) are priced at 0, while write operations like sending messages or creating drafts cost 0.01, and creating domains costs 10.
Authentication is via Bearer token in the Authorization header. The API uses standard pagination with page tokens and supports filtering by labels, timestamps, and sort order across its list endpoints.
Capabilities
Use cases
- —Give each AI agent its own email address to send and receive messages autonomously
- —Automate customer support workflows where agents handle inbound email threads
- —Create disposable or scoped inboxes for agent tasks like sign-ups, verifications, or outreach
- —Monitor email delivery metrics (bounces, complaints) for agent-sent messages
- —Use webhooks to trigger agent actions in real-time when new emails arrive
Fit
Best for
- —AI agent developers who need programmatic email send/receive capabilities
- —Multi-agent systems where each agent requires an isolated inbox
- —Automation pipelines that interact with external services via email
Not for
- —Human-facing email clients or webmail replacements
- —Bulk marketing email campaigns (no indication of high-volume marketing features)
- —Non-agent use cases that already have traditional SMTP/IMAP integrations
Quick start
curl -X POST https://mpp.api.agentmail.to/v0/pods/YOUR_POD_ID/inboxes \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"username": "hello", "domain": "agentmail.to", "display_name": "My Agent"}'Example
Request
{
"domain": "agentmail.to",
"username": "hello",
"client_id": "client-abc-123",
"display_name": "My Agent"
}Response
{
"pod_id": "pod_abc123",
"inbox_id": "hello@agentmail.to",
"client_id": "client-abc-123",
"created_at": "2025-01-15T10:30:00Z",
"updated_at": "2025-01-15T10:30:00Z",
"display_name": "My Agent"
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed component definitions and clear endpoint structure. MPP challenge is live and captured. Pricing units and currency are present but the token contract address makes exact dollar conversion uncertain. No standalone docs page was reachable on the MPP gateway, though the main site provides context.
Warnings
- —Currency contract address 0x20C0...8b50 on chain 4217 is not a well-known stablecoin; exact dollar price for the 'Create Inbox' operation (price: 2) cannot be confirmed without knowing the token's decimals.
- —Documentation paths (/docs, /api) on the MPP gateway return 404; full docs are at docs.agentmail.to which was not crawled.
Citations
- —AgentMail is the email inbox API for AI agents, providing agents their own email inboxes.https://mpp.api.agentmail.to
- —Create Inbox endpoint at /v0/pods/{pod_id}/inboxes has a fixed MPP price of 2.https://mpp.api.agentmail.to
- —The MPP challenge uses method 'tempo' with intent 'charge' on chainId 4217.https://mpp.api.agentmail.to
- —AgentMail raised $6M in Seed Funding and is backed by Y Combinator.https://mpp.api.agentmail.to
- —The API supports inboxes, messages, threads, drafts, domains, webhooks, lists, and metrics as documented in the OpenAPI spec.https://mpp.api.agentmail.to