Knowledge Base
Getting Started
What AgentMail is and how it differs from sending-only email APIs.
CC, BCC, forwarding, threading, attachments, labels, IMAP, and more.
Get up and running with your first AgentMail inbox.
Google account photos, BIMI logos, and certificate requirements.
How to create and manage your API keys.
Take ownership of an inbox your agent created without your email.
Limits on agent-created accounts, and how verifying or claiming lifts them.
Account & Billing
What each suspension reason means, what still works, and how to get help.
Change your plan, manage invoices and payment methods, or cancel.
SOC 2, subprocessors, privacy, data residency, and where to send questions.
Agent Patterns
Webhooks vs WebSockets vs polling for receiving emails.
Control who can send to and receive from your inboxes.
Build agents that maintain context across email threads.
Add human review and approval steps to your agent workflows.
Isolate inboxes and data across tenants with Pods.
Use labels to manage agent workflow state on emails.
Domains & Deliverability
Send emails from your own domain instead of @agentmail.to.
Create inboxes on any subdomain of a verified domain.
Authenticate your domain for better deliverability.
Troubleshoot and fix spam folder placement issues.
Gradually build sending reputation on a new domain.
Add AgentMail DNS records without breaking existing email.
What kinds of email AgentMail is built for, and how to honor opt-outs.
Troubleshooting
What each 403 error code means and how to fix it.
Understand AgentMail’s rate limits and how to work within them.
Use idempotency to avoid sending the same email twice.
What to do when your domain verification is stuck.
Diagnose and resolve email bounce issues.
Why an inbound email was dropped, labeled, or hidden, and how to find it.
AI Tools
Resources for onboarding AI agents and coding assistants to AgentMail.
Connect AgentMail to Claude, ChatGPT, Cursor, and other MCP clients.
Add AgentMail to AI coding assistants with the official skill.
Manage AgentMail resources from the command line.
DNS Guides
Step-by-step instructions for verifying your domain with popular DNS providers.
Configure AgentMail DNS records in Cloudflare.
Configure AgentMail DNS records in GoDaddy.
Configure AgentMail DNS records in AWS Route 53.
Configure AgentMail DNS records in Namecheap.
Can’t find what you need?
Email support@agentmail.cc with your organization ID and, if relevant, the inbox ID, message ID, and the time the problem happened. Check status.agentmail.to for ongoing incidents.