Agent Email
Dedicated email addresses for AI agents with Gmail-like inbox management and Mailgun-like deliverability.
What is Agent Email?
Agent Email gives your AI agents their own dedicated email addresses with full bidirectional mailbox capabilities. Unlike transactional email — which is fire-and-forget (send a password reset, done) — Agent Email provides a complete inbox that agents can read, search, reply to, and manage programmatically.
Think of it as Gmail for agents meets Mailgun for deliverability:
| Transactional Email | Agent Email | |
|---|---|---|
| Direction | Outbound only | Full bidirectional |
| Inbox | No inbox | Full inbox with read, search, labels |
| Threading | No thread tracking | Automatic thread management |
| Identity | Shared sender | Dedicated mailbox per agent |
| Use case | Notifications, receipts | Agent communication, research, outreach |
Key Features
- Mailbox creation — Programmatically create email addresses for each agent (
research-agent@agentmail.usetransactional.comor your custom domain) - Send and receive — Full outbound sending with the same 99.9% deliverability as transactional email, plus inbound processing with sub-2s latency
- Inbox API — List, search, read, label, archive, and mark messages as read/unread
- Thread tracking — Automatic threading via
In-Reply-ToandReferencesheaders with reply, reply-all, and forward support - Webhooks — Real-time notifications for incoming messages, bounces, and delivery events
- Custom domains — Bring your own domain with full DKIM, SPF, and DMARC configuration
- Per-agent authentication — Each mailbox gets isolated API keys and rate limits
When to Use Agent Email
| Use Case | Example |
|---|---|
| Research agents | Agent emails experts, collects responses, synthesizes findings |
| Sales outreach | Agent sends personalized outreach and handles replies |
| Customer support | Agent manages a support inbox and triages incoming requests |
| Workflow automation | Agent coordinates with external services via email |
| Data collection | Agent sends surveys and processes responses |
How It Works
Your Agent
|
v
tx.agentEmail.mailboxes.create({ name: 'my-agent' })
|
v
+-------------------------------+
| Dedicated Mailbox |
| my-agent@agentmail.use... |
| - Send emails |
| - Receive inbound |
| - Read inbox |
| - Manage threads |
+-------------------------------+
|
v
Webhooks / Polling for new mail
- Create a mailbox — Your agent gets a dedicated email address
- Send emails — Deliver messages with the same infrastructure as transactional email
- Receive and read — Inbound emails are available via API in under 2 seconds
- Reply and thread — Maintain conversation context with automatic threading
Next Steps
- Quickstart — Create a mailbox and send your first email in 5 minutes
- Sending Email — Send API with attachments, templates, and scheduling
- Inbox Management — Full inbox API reference
- Webhooks — Real-time event notifications