Documentation
Guides and reference for sending, receiving and routing mail, and for connecting your code and agents to it.
⌘K
Guides
- Quick startConnect a domain, verify DNS and send your first message.
- AuthenticationCreate API keys, choose scopes and authenticate requests.
- Sending emailSend through your configured provider with attachments and replies.
- Receiving emailSet up inbound mail and decide where each message goes.
- WebhooksEvent payloads for new mail, bounces and verified domains, and how to check signatures.
- Routing rulesForward, label, store, call a webhook or discard, in priority order.
- API referenceEndpoints, request bodies, response codes and pagination.
- MCP serverConnect Claude Code or any MCP client to your mail.
- Agent IDsFree, receive-only addresses for AI agents, with a paid upgrade to send.
- Sending providersUse Resend, Amazon SES, Postmark, Mailgun or SendGrid.
- Self-hostingRun the Mailpipe backend on your own Supabase project and keys.
- FAQSetup, billing and troubleshooting answers.
Your first call
Create a key under Settings, API keys, then list the newest mail across your mailboxes.
List messages
$ curl "https://api.mailpipe.dev/v1/messages?limit=10&unread=true" \
-H "Authorization: Bearer mp_live_your-api-key"