Create a pod to organize email inboxes, domains, and threads for AI agents via AgentMail's MPP API.
What it does
This endpoint creates a "pod" on AgentMail, an email infrastructure service that provides programmatic email inboxes for AI agents. A pod is an organizational container that groups inboxes, domains, threads, drafts, and allow/block lists together. The endpoint is part of a comprehensive REST API exposed over the MPP (Micropayment Protocol) gateway at mpp.api.agentmail.to.
The Create Pod operation accepts a POST request to /v0/pods with an optional JSON body containing a pod name and client_id. It returns a Pod object with the assigned pod_id, name, and timestamps. The endpoint is priced at a fixed cost per call, settled via the Tempo method on chain 4217. Once a pod is created, you can nest inboxes (POST /v0/pods/{pod_id}/inboxes), custom domains, threads, drafts, webhooks, and allow/block lists under it. Other operations on pods—list, get, delete—are free (price 0).
The broader AgentMail MPP API covers the full email lifecycle: creating inboxes (fixed price ~$2 per inbox), sending/replying/forwarding messages (~$0.01 each), managing drafts, custom domain verification, webhook subscriptions, metrics queries, and allow/block list management. All read operations and most management operations are priced at 0. Authentication is via Bearer token in the Authorization header. The API uses OpenAPI 3.1.0 and the MPP 402 payment challenge flow for billing.
Capabilities
Use cases
- —Provisioning isolated email environments (pods) for different AI agent workflows
- —Giving AI agents their own email addresses to send and receive messages autonomously
- —Automating customer support email threads with agent-managed inboxes
- —Organizing multi-tenant agent email infrastructure with pods and custom domains
- —Receiving webhook notifications when agents get new emails
Fit
Best for
- —AI agent developers who need programmatic email send/receive
- —Multi-agent systems requiring isolated email namespaces
- —Automation pipelines that interact with external parties via email
Not for
- —Human-facing email clients or webmail replacements
- —Bulk marketing email campaigns
- —Reading from existing Gmail/Outlook mailboxes
Quick start
curl -X POST https://mpp.api.agentmail.to/v0/pods \
-H "Authorization: Bearer <MPP_TOKEN>" \
-H "Content-Type: application/json" \
-d '{"name": "my-agent-pod"}'Example
Request
{
"name": "my-agent-pod",
"client_id": "client_abc123"
}Response
{
"name": "my-agent-pod",
"pod_id": "pod_xYz789",
"client_id": "client_abc123",
"created_at": "2025-01-15T10:30:00Z",
"updated_at": "2025-01-15T10:30:00Z"
}Endpoint
Quality
Full OpenAPI 3.1.0 schema with detailed component definitions, live 402 MPP challenge captured, and clear pricing annotations on every operation. Docs pages on the MPP gateway itself return 404 (docs are at docs.agentmail.to), and no example responses are provided in the spec, so examples are inferred from the schema.
Warnings
- —The currency address 0x20C000000000000000000000b9537d11c60E8b50 and chain 4217 (Tempo L2) are not widely documented; confirm token decimals before relying on converted prices.
- —The Create Pod price field is '0.010000' in x-payment-info but the exact denomination/decimals of the Tempo settlement token are not explicitly stated in the probe.
- —Documentation endpoints on the MPP gateway (/docs, /api, /pricing) all return 404; full docs are hosted separately at docs.agentmail.to.
Citations
- —AgentMail is an email inbox API for AI agents, backed by $6M seed funding and Y Combinator.https://mpp.api.agentmail.to
- —Create Pod endpoint is POST /v0/pods with fixed price 0.010000 via MPP.https://mpp.api.agentmail.to
- —The MPP challenge uses method 'tempo' with intent 'charge' on chainId 4217.https://mpp.api.agentmail.to/v0/pods
- —Create Inbox is priced at 2.000000 and Send Message at 0.01 per the OpenAPI x-payment-info annotations.https://mpp.api.agentmail.to
- —The API uses OpenAPI 3.1.0 with Bearer authentication.https://mpp.api.agentmail.to