> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://www.agentmail.to/docs/llms.txt. # Knowledge Base > AgentMail is the first email provider built for AI agents. Create inboxes, send and receive messages, manage threads, and handle webhooks programmatically. Free tier, no credit card required. ## Docs - [What is AgentMail and how is it different?](https://agentmail.to/docs/knowledge-base/what-is-agentmail.md): Understand what AgentMail gives an AI agent and when to use it. - [What can I do with an AgentMail inbox?](https://agentmail.to/docs/knowledge-base/inbox-capabilities.md): A complete overview of inbox capabilities for AI agents. - [Can I set a profile picture for my inbox?](https://agentmail.to/docs/knowledge-base/inbox-profile-pictures.md): Learn how to associate a Google profile picture with an AgentMail address, how BIMI logos differ, and when Gmail requires a VMC or CMC certificate. - [How do I create my first inbox?](https://agentmail.to/docs/knowledge-base/creating-first-inbox.md): Get up and running with your first AgentMail inbox. - [How do I get my API key?](https://agentmail.to/docs/knowledge-base/getting-api-key.md): Create and manage your AgentMail API keys. - [How do I claim my agent's inbox?](https://agentmail.to/docs/knowledge-base/claiming-agent-inbox.md): Take ownership of an inbox your agent created without your email. - [Why can my agent only email its human?](https://agentmail.to/docs/knowledge-base/agent-sign-up-limits.md): The limits on an account an agent created for itself, the errors it sees, and how verification lifts them. - [Why was my account suspended?](https://agentmail.to/docs/knowledge-base/account-suspended.md): What each suspension reason means, what still works while suspended, and how to get a review. - [How do I upgrade, downgrade, or cancel my plan?](https://agentmail.to/docs/knowledge-base/change-plan-billing.md): Change your plan, manage payment methods and invoices, or cancel from the AgentMail Console. - [Security and compliance FAQ](https://agentmail.to/docs/knowledge-base/security-compliance.md): SOC 2, subprocessors, privacy, data residency, retention, email authentication, and where to send other questions. - [How do I handle inbound emails with my agent?](https://agentmail.to/docs/knowledge-base/handling-inbound-emails.md): Compare webhooks, WebSockets, and polling webhooks for processing incoming emails. - [How do I set up allowlists and blocklists?](https://agentmail.to/docs/knowledge-base/allowlists-blocklists.md): Control who your AI agent can send to and receive from. - [How do I manage threaded conversations?](https://agentmail.to/docs/knowledge-base/threaded-conversations.md): Maintain context across multi-turn email conversations with your agent. - [How do I build a human-in-the-loop workflow?](https://agentmail.to/docs/knowledge-base/human-in-the-loop.md): Keep humans in control of your agent's email communications. - [How do I use Pods for multi-tenant email?](https://agentmail.to/docs/knowledge-base/pods-multi-tenant.md): Isolate inboxes, domains, and data across tenants with Pods. - [How do I use labels to track email state?](https://agentmail.to/docs/knowledge-base/labels-track-state.md): Use labels to manage agent workflow state on emails and threads. - [How do I set up a custom domain?](https://agentmail.to/docs/knowledge-base/custom-domain-setup.md): Send emails from your own domain instead of @agentmail.to. - [How do I create inboxes on any subdomain?](https://agentmail.to/docs/knowledge-base/subdomain-inboxes.md): Register one parent domain and use it for inboxes across its subdomains. - [How do I set up SPF, DKIM, and DMARC?](https://agentmail.to/docs/knowledge-base/spf-dkim-dmarc.md): Authenticate your domain for reliable email deliverability. - [Why are my emails going to spam?](https://agentmail.to/docs/knowledge-base/emails-going-to-spam.md): Troubleshoot and fix spam folder placement issues. - [Warming Up](https://agentmail.to/docs/knowledge-base/domain-warming.md): Gradually build sending reputation on a new domain or inbox. - [How do I avoid MX record conflicts?](https://agentmail.to/docs/knowledge-base/mx-record-conflicts.md): Add AgentMail DNS records without breaking existing email. - [Can my agent send cold outreach?](https://agentmail.to/docs/knowledge-base/cold-outreach.md): AgentMail does not support cold outreach. Here is what it is built for, and how to handle opt-outs. - [What does a 403 error mean?](https://agentmail.to/docs/knowledge-base/api-403-error.md): Common causes of API 403 Forbidden errors and how to fix them. - [What are the rate limits?](https://agentmail.to/docs/knowledge-base/rate-limits.md): Understand AgentMail's sending limits and API rate limits, and how to work within them. - [How do I prevent duplicate sends?](https://agentmail.to/docs/knowledge-base/preventing-duplicate-sends.md): Use idempotency to avoid sending the same email twice. - [Why is my domain not verifying?](https://agentmail.to/docs/knowledge-base/domain-not-verifying.md): What to do when your domain verification is stuck. - [Why are my emails bouncing?](https://agentmail.to/docs/knowledge-base/emails-bouncing.md): Diagnose and resolve email bounce issues. - [Why are my emails not showing up?](https://agentmail.to/docs/knowledge-base/inbound-emails-missing.md): The most common reason inbound emails go missing is that the sender's domain failed authentication. - [DNS Guide: Cloudflare](https://agentmail.to/docs/knowledge-base/dns-cloudflare.md): Step-by-step instructions for adding AgentMail DNS records in Cloudflare. - [DNS Guide: GoDaddy](https://agentmail.to/docs/knowledge-base/dns-godaddy.md): Step-by-step instructions for adding AgentMail DNS records in GoDaddy. - [DNS Guide: Route 53 (AWS)](https://agentmail.to/docs/knowledge-base/dns-route53.md): Step-by-step instructions for adding AgentMail DNS records in AWS Route 53. - [DNS Guide: Namecheap](https://agentmail.to/docs/knowledge-base/dns-namecheap.md): Step-by-step instructions for adding AgentMail DNS records in Namecheap. > **Note:** This page contains both a page directory (above) and the landing page content (below). The page directory is generated for agent use and does not appear on the landing page. > For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://www.agentmail.to/docs/llms.txt. # Knowledge Base ## Getting Started #### [What is AgentMail?](/knowledge-base/what-is-agentmail) What AgentMail is and how it differs from sending-only email APIs. #### [What can I do with an inbox?](/knowledge-base/inbox-capabilities) CC, BCC, forwarding, threading, attachments, labels, IMAP, and more. #### [Creating your first inbox](/knowledge-base/creating-first-inbox) Get up and running with your first AgentMail inbox. #### [Inbox profile pictures](/knowledge-base/inbox-profile-pictures) Google account photos, BIMI logos, and certificate requirements. #### [Getting your API key](/knowledge-base/getting-api-key) How to create and manage your API keys. #### [Claiming your agent's inbox](/knowledge-base/claiming-agent-inbox) Take ownership of an inbox your agent created without your email. #### [Why can my agent only email its human?](/knowledge-base/agent-sign-up-limits) Limits on agent-created accounts, and how verifying or claiming lifts them. ## Account & Billing #### [Why was my account suspended?](/knowledge-base/account-suspended) What each suspension reason means, what still works, and how to get help. #### [Upgrade, downgrade, or cancel](/knowledge-base/change-plan-billing) Change your plan, manage invoices and payment methods, or cancel. #### [Security and compliance FAQ](/knowledge-base/security-compliance) SOC 2, subprocessors, privacy, data residency, and where to send questions. ## Agent Patterns #### [Handling inbound emails](/knowledge-base/handling-inbound-emails) Webhooks vs WebSockets vs polling for receiving emails. #### [Allowlists & blocklists](/knowledge-base/allowlists-blocklists) Control who can send to and receive from your inboxes. #### [Managing threaded conversations](/knowledge-base/threaded-conversations) Build agents that maintain context across email threads. #### [Human-in-the-loop workflows](/knowledge-base/human-in-the-loop) Add human review and approval steps to your agent workflows. #### [Pods for multi-tenant email](/knowledge-base/pods-multi-tenant) Isolate inboxes and data across tenants with Pods. #### [Using labels to track state](/knowledge-base/labels-track-state) Use labels to manage agent workflow state on emails. ## Domains & Deliverability #### [Custom domain setup](/knowledge-base/custom-domain-setup) Send emails from your own domain instead of @agentmail.to. #### [Inboxes on subdomains](/knowledge-base/subdomain-inboxes) Create inboxes on any subdomain of a verified domain. #### [SPF, DKIM, and DMARC setup](/knowledge-base/spf-dkim-dmarc) Authenticate your domain for better deliverability. #### [Emails going to spam](/knowledge-base/emails-going-to-spam) Troubleshoot and fix spam folder placement issues. #### [Warming up a new domain](/knowledge-base/domain-warming) Gradually build sending reputation on a new domain. #### [MX record conflicts](/knowledge-base/mx-record-conflicts) Add AgentMail DNS records without breaking existing email. #### [Can my agent send cold outreach?](/knowledge-base/cold-outreach) What kinds of email AgentMail is built for, and how to honor opt-outs. ## Troubleshooting #### [API 403 error](/knowledge-base/api-403-error) What each 403 error code means and how to fix it. #### [Rate limits](/knowledge-base/rate-limits) Understand AgentMail's rate limits and how to work within them. #### [Preventing duplicate sends](/knowledge-base/preventing-duplicate-sends) Use idempotency to avoid sending the same email twice. #### [Domain not verifying](/knowledge-base/domain-not-verifying) What to do when your domain verification is stuck. #### [Emails bouncing](/knowledge-base/emails-bouncing) Diagnose and resolve email bounce issues. #### [Why are my emails not showing up?](/knowledge-base/inbound-emails-missing) Why an inbound email was dropped, labeled, or hidden, and how to find it. ## AI Tools #### [Agent onboarding](/agent-onboarding) Resources for onboarding AI agents and coding assistants to AgentMail. #### [MCP server](/integrations/mcp) Connect AgentMail to Claude, ChatGPT, Cursor, and other MCP clients. #### [Skills](/integrations/skills) Add AgentMail to AI coding assistants with the official skill. #### [CLI](/integrations/cli) Manage AgentMail resources from the command line. ## DNS Guides Step-by-step instructions for verifying your domain with popular DNS providers. #### [Cloudflare DNS Guide](/knowledge-base/dns-cloudflare) Configure AgentMail DNS records in Cloudflare. #### [GoDaddy DNS Guide](/knowledge-base/dns-godaddy) Configure AgentMail DNS records in GoDaddy. #### [Route 53 DNS Guide](/knowledge-base/dns-route53) Configure AgentMail DNS records in AWS Route 53. #### [Namecheap DNS Guide](/knowledge-base/dns-namecheap) Configure AgentMail DNS records in Namecheap. ## Can't find what you need? Email [support@agentmail.cc](mailto: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](https://status.agentmail.to) for ongoing incidents.