# AgentMail | Documentation

## Docs

- [Welcome](https://docs.agentmail.to/welcome.mdx): Your starting point for building with the AgentMail API.
- [Introduction](https://docs.agentmail.to/introduction.mdx): Give AI agents email inboxes
- [Quickstart](https://docs.agentmail.to/quickstart.mdx): Follow this guide to make your first AgentMail API request and create a new email inbox.
- [Inboxes](https://docs.agentmail.to/inboxes.mdx): Learn how AgentMail Inboxes act as scalable, API-first email accounts for your agents.
- [Messages](https://docs.agentmail.to/messages.mdx): Learn how to send, receive, and manage emails as Message objects with the AgentMail API.
- [Threads](https://docs.agentmail.to/threads.mdx): Learn how AgentMail Threads group messages into conversations and how to query them across your entire organization.
- [Drafts](https://docs.agentmail.to/drafts.mdx): Learn how to create, manage, and send Drafts to enable advanced agent workflows like human-in-the-loop review and scheduled sending.
- [Labels](https://docs.agentmail.to/labels.mdx): Learn how to use Labels to manage state, track campaigns, and filter messages for powerful agentic workflows.
- [Lists](https://docs.agentmail.to/lists.mdx): Learn how to use Lists to control which email addresses and domains your agents can send to or receive from.
- [Attachments](https://docs.agentmail.to/attachments.mdx): Learn how to send files as attachments, and download incoming attachments from both messages and threads.
- [Pods](https://docs.agentmail.to/documentation/core-concepts/pods.mdx): Learn how to use pods for multi-tenant email management
- [Permissions](https://docs.agentmail.to/permissions.mdx): Learn how to configure fine-grained permissions on API keys to restrict access to specific resources and operations.
- [Agent Onboarding](https://docs.agentmail.to/agent-onboarding.mdx): Resources for AI coding assistants, MCP servers, skills, and agent-friendly documentation.
- [Skills](https://docs.agentmail.to/integrations/skills.mdx): AgentMail's official skill for OpenClaw, Claude Code, Cursor, and other AI assistants
- [MCP](https://docs.agentmail.to/integrations/mcp.mdx): AgentMail's Model Context Protocol (MCP) integration
- [CLI](https://docs.agentmail.to/integrations/cli.mdx): AgentMail's official command-line interface
- [Google ADK](https://docs.agentmail.to/integrations/google-adk.mdx): AgentMail's Google Agent Development Kit (ADK) integration
- [OpenClaw](https://docs.agentmail.to/integrations/openclaw.mdx): AgentMail's OpenClaw integration
- [Replit](https://docs.agentmail.to/integrations/replit.mdx): AgentMail's Replit integration
- [x402](https://docs.agentmail.to/integrations/x402.mdx): AgentMail's x402 integration for HTTP-native payments
- [MPP](https://docs.agentmail.to/integrations/mpp.mdx): AgentMail's MPP integration for machine-to-machine payments via Stripe
- [Integrate LiveKit Agents](https://docs.agentmail.to/integrate-livekit-agents.mdx): A step-by-step guide to integrate with the LiveKit Agents SDK.
- [Sim.ai](https://docs.agentmail.to/integrations/sim.mdx): AgentMail's Sim.ai integration
- [Guide: Sending & Receiving Email](https://docs.agentmail.to/sending-receiving-email.mdx): A step-by-step guide to the practical workflow of sending initial emails and handling replies to have a full conversation.
- [IMAP & SMTP](https://docs.agentmail.to/imap-smtp.mdx): Configure IMAP and SMTP to access your AgentMail inboxes using email clients or programmatic access.
- [Guide: Multi-Tenancy](https://docs.agentmail.to/multi-tenancy.mdx): How to use pods, scoped API keys, and webhook filtering to build multi-tenant email on AgentMail.
- [Using Custom Domains](https://docs.agentmail.to/custom-domains.mdx): A step-by-step guide to configuring your custom domain with AgentMail for enhanced branding and trust.
- [Managing Your Domains](https://docs.agentmail.to/managing-domains.mdx): Learn how to manage your custom domains effectively using AgentMail's API for enhanced deliverability and reputation management.
- [Webhooks Overview](https://docs.agentmail.to/overview.mdx): Learn how to use Webhooks to build responsive, event-driven email agents with AgentMail.
- [Webhook Events](https://docs.agentmail.to/events.mdx)
- [Webhook Setup Guide](https://docs.agentmail.to/webhook-setup.mdx): A comprehensive guide to setting up webhooks with ngrok and AgentMail, including account creation, inbox setup, and code examples.
- [Verifying Webhooks](https://docs.agentmail.to/webhook-verification.mdx): Learn how to verify webhook signatures to secure your webhook endpoints and prevent spoofed requests.
- [WebSockets](https://docs.agentmail.to/websockets.mdx): Learn how to use WebSockets for instant email notifications without webhooks or polling.
- [WebSockets Quickstart](https://docs.agentmail.to/websockets/quickstart.mdx): Get started with real-time email event streaming
- [Email Deliverability](https://docs.agentmail.to/email-deliverability.mdx): Learn the strategies and best practices for maximizing your email deliverability with AgentMail.
- [Idempotent Requests](https://docs.agentmail.to/idempotency.mdx): A guide to using the client_id parameter in AgentMail to prevent duplicate resources and safely retry API requests.
- [Example: Event-Driven Agent](https://docs.agentmail.to/webhook-agent.mdx): A step-by-step guide to building a sophisticated agent that performs proactive outreach and uses webhooks for inbound message processing.
- [Auto-Reply Email Agent](https://docs.agentmail.to/documentation/examples/auto-reply-agent.mdx): Build a simple agent that automatically responds to incoming emails with personalized messages
- [Smart Email Labeling Agent](https://docs.agentmail.to/documentation/examples/smart-labeling-agent.mdx): Build an AI-powered agent that automatically classifies and labels incoming emails across multiple dimensions
- [Sales Agent with WebSocket](https://docs.agentmail.to/sales-agent-websocket.mdx): A step-by-step guide to building an AI-powered sales agent that uses WebSocket for real-time email processing without polling or webhooks.
- [Live AgentMail Examples](https://docs.agentmail.to/documentation/examples/live-agent-mail-examples.mdx)
- [Frequently Asked Questions (FAQ)](https://docs.agentmail.to/faq.mdx): Find answers to common questions about AgentMail, from core concepts to best practices and security.
- [Email Reply Extraction with Talon](https://docs.agentmail.to/talon-reply-extraction.mdx): Learn how to use Talon to extract new content from email replies, removing quoted text with 93.8% accuracy.
- [Join the AgentMail Community](https://docs.agentmail.to/community.mdx): Connect with the AgentMail team and developers, share what you're building, and get support.
- [Support](https://docs.agentmail.to/support.mdx): Get help with AgentMail through our support channels.
- [Understanding Email Authentication (SPF, DKIM, DMARC)](https://docs.agentmail.to/email-protocols.mdx): Learn why we ask for DNS records and what SPF, DKIM, and DMARC are.
- [SOC 2 Compliance](https://docs.agentmail.to/documentation/resources/security-privacy/soc-2-compliance.mdx): AgentMail's SOC 2 Type I and Type II compliance.
- [Spam & Virus Detection](https://docs.agentmail.to/spam-virus-detection.mdx): How AgentMail automatically scans incoming emails for spam and viruses.
- [API Welcome](https://docs.agentmail.to/api-reference.mdx): Quick overview of the AgentMail SDK
- [Knowledge Base](https://docs.agentmail.to/knowledge-base.mdx): A collection of answers to frequently asked questions.
- [What is AgentMail and how is it different?](https://docs.agentmail.to/knowledge-base/what-is-agentmail.mdx): Understand how AgentMail compares to traditional email providers.
- [What can I do with an AgentMail inbox?](https://docs.agentmail.to/knowledge-base/inbox-capabilities.mdx): A complete overview of inbox capabilities for AI agents.
- [How do I create my first inbox?](https://docs.agentmail.to/knowledge-base/creating-first-inbox.mdx): Get up and running with your first AgentMail inbox.
- [How do I get my API key?](https://docs.agentmail.to/knowledge-base/getting-api-key.mdx): Create and manage your AgentMail API keys.
- [How do I handle inbound emails with my agent?](https://docs.agentmail.to/knowledge-base/handling-inbound-emails.mdx): Compare Webhooks and WebSockets for processing incoming emails.
- [How do I set up allowlists and blocklists?](https://docs.agentmail.to/knowledge-base/allowlists-blocklists.mdx): Control who your AI agent can send to and receive from.
- [How do I manage threaded conversations?](https://docs.agentmail.to/knowledge-base/threaded-conversations.mdx): Maintain context across multi-turn email conversations with your agent.
- [How do I build a human-in-the-loop workflow?](https://docs.agentmail.to/knowledge-base/human-in-the-loop.mdx): Keep humans in control of your agent's email communications.
- [How do I use Pods for multi-tenant email?](https://docs.agentmail.to/knowledge-base/pods-multi-tenant.mdx): Isolate inboxes, domains, and data across tenants with Pods.
- [How do I use labels to track email state?](https://docs.agentmail.to/knowledge-base/labels-track-state.mdx): Use labels to manage agent workflow state on emails and threads.
- [How do I set up a custom domain?](https://docs.agentmail.to/knowledge-base/custom-domain-setup.mdx): Send emails from your own domain instead of @agentmail.to.
- [How do I set up SPF, DKIM, and DMARC?](https://docs.agentmail.to/knowledge-base/spf-dkim-dmarc.mdx): Authenticate your domain for reliable email deliverability.
- [Why are my emails going to spam?](https://docs.agentmail.to/knowledge-base/emails-going-to-spam.mdx): Troubleshoot and fix spam folder placement issues.
- [Warming Up](https://docs.agentmail.to/knowledge-base/domain-warming.mdx): Gradually build sending reputation on a new domain or inbox.
- [How do I avoid MX record conflicts?](https://docs.agentmail.to/knowledge-base/mx-record-conflicts.mdx): Add AgentMail DNS records without breaking existing email.
- [What does a 403 error mean?](https://docs.agentmail.to/knowledge-base/api-403-error.mdx): Common causes of API 403 Forbidden errors and how to fix them.
- [What are the rate limits?](https://docs.agentmail.to/knowledge-base/rate-limits.mdx): Understand AgentMail's rate limits and how to work within them.
- [How do I prevent duplicate sends?](https://docs.agentmail.to/knowledge-base/preventing-duplicate-sends.mdx): Use idempotency to avoid sending the same email twice.
- [Why is my domain not verifying?](https://docs.agentmail.to/knowledge-base/domain-not-verifying.mdx): What to do when your domain verification is stuck.
- [Why are my emails bouncing?](https://docs.agentmail.to/knowledge-base/emails-bouncing.mdx): Diagnose and resolve email bounce issues.
- [DNS Guide: Cloudflare](https://docs.agentmail.to/knowledge-base/dns-cloudflare.mdx): Step-by-step instructions for adding AgentMail DNS records in Cloudflare.
- [DNS Guide: GoDaddy](https://docs.agentmail.to/knowledge-base/dns-godaddy.mdx): Step-by-step instructions for adding AgentMail DNS records in GoDaddy.
- [DNS Guide: Route 53 (AWS)](https://docs.agentmail.to/knowledge-base/dns-route53.mdx): Step-by-step instructions for adding AgentMail DNS records in AWS Route 53.
- [DNS Guide: Namecheap](https://docs.agentmail.to/knowledge-base/dns-namecheap.mdx): Step-by-step instructions for adding AgentMail DNS records in Namecheap.

## API Docs

- API Reference > Agent [Sign Up](https://docs.agentmail.to/api-reference/agent/sign-up.mdx)
- API Reference > Agent [Verify](https://docs.agentmail.to/api-reference/agent/verify.mdx)
- API Reference > Inboxes [List Inboxes](https://docs.agentmail.to/api-reference/inboxes/list.mdx)
- API Reference > Inboxes [Get Inbox](https://docs.agentmail.to/api-reference/inboxes/get.mdx)
- API Reference > Inboxes [Create Inbox](https://docs.agentmail.to/api-reference/inboxes/create.mdx)
- API Reference > Inboxes [Update Inbox](https://docs.agentmail.to/api-reference/inboxes/update.mdx)
- API Reference > Inboxes [Delete Inbox](https://docs.agentmail.to/api-reference/inboxes/delete.mdx)
- API Reference > Inboxes > Threads [List Threads](https://docs.agentmail.to/api-reference/inboxes/threads/list.mdx)
- API Reference > Inboxes > Threads [Get Thread](https://docs.agentmail.to/api-reference/inboxes/threads/get.mdx)
- API Reference > Inboxes > Threads [Get Attachment](https://docs.agentmail.to/api-reference/inboxes/threads/get-attachment.mdx)
- API Reference > Inboxes > Threads [Update Thread](https://docs.agentmail.to/api-reference/inboxes/threads/update.mdx)
- API Reference > Inboxes > Threads [Delete Thread](https://docs.agentmail.to/api-reference/inboxes/threads/delete.mdx)
- API Reference > Inboxes > Messages [List Messages](https://docs.agentmail.to/api-reference/inboxes/messages/list.mdx)
- API Reference > Inboxes > Messages [Get Message](https://docs.agentmail.to/api-reference/inboxes/messages/get.mdx)
- API Reference > Inboxes > Messages [Get Attachment](https://docs.agentmail.to/api-reference/inboxes/messages/get-attachment.mdx)
- API Reference > Inboxes > Messages [Get Raw Message](https://docs.agentmail.to/api-reference/inboxes/messages/get-raw.mdx)
- API Reference > Inboxes > Messages [Update Message](https://docs.agentmail.to/api-reference/inboxes/messages/update.mdx)
- API Reference > Inboxes > Messages [Delete Message](https://docs.agentmail.to/api-reference/inboxes/messages/delete.mdx)
- API Reference > Inboxes > Messages [Send Message](https://docs.agentmail.to/api-reference/inboxes/messages/send.mdx)
- API Reference > Inboxes > Messages [Reply To Message](https://docs.agentmail.to/api-reference/inboxes/messages/reply.mdx)
- API Reference > Inboxes > Messages [Reply All Message](https://docs.agentmail.to/api-reference/inboxes/messages/reply-all.mdx)
- API Reference > Inboxes > Messages [Forward Message](https://docs.agentmail.to/api-reference/inboxes/messages/forward.mdx)
- API Reference > Inboxes > Drafts [List Drafts](https://docs.agentmail.to/api-reference/inboxes/drafts/list.mdx)
- API Reference > Inboxes > Drafts [Get Draft](https://docs.agentmail.to/api-reference/inboxes/drafts/get.mdx)
- API Reference > Inboxes > Drafts [Get Attachment](https://docs.agentmail.to/api-reference/inboxes/drafts/get-attachment.mdx)
- API Reference > Inboxes > Drafts [Create Draft](https://docs.agentmail.to/api-reference/inboxes/drafts/create.mdx)
- API Reference > Inboxes > Drafts [Update Draft](https://docs.agentmail.to/api-reference/inboxes/drafts/update.mdx)
- API Reference > Inboxes > Drafts [Delete Draft](https://docs.agentmail.to/api-reference/inboxes/drafts/delete.mdx)
- API Reference > Inboxes > Drafts [Send Draft](https://docs.agentmail.to/api-reference/inboxes/drafts/send.mdx)
- API Reference > Inboxes > Lists [List Entries](https://docs.agentmail.to/api-reference/inboxes/lists/list.mdx)
- API Reference > Inboxes > Lists [Get List Entry](https://docs.agentmail.to/api-reference/inboxes/lists/get.mdx)
- API Reference > Inboxes > Lists [Create List Entry](https://docs.agentmail.to/api-reference/inboxes/lists/create.mdx)
- API Reference > Inboxes > Lists [Delete List Entry](https://docs.agentmail.to/api-reference/inboxes/lists/delete.mdx)
- API Reference > Inboxes > Metrics [Query Metrics](https://docs.agentmail.to/api-reference/inboxes/metrics/query.mdx)
- API Reference > Inboxes > API Keys [List API Keys](https://docs.agentmail.to/api-reference/inboxes/api-keys/list.mdx)
- API Reference > Inboxes > API Keys [Create API Key](https://docs.agentmail.to/api-reference/inboxes/api-keys/create.mdx)
- API Reference > Inboxes > API Keys [Delete API Key](https://docs.agentmail.to/api-reference/inboxes/api-keys/delete.mdx)
- API Reference > Threads [List Threads](https://docs.agentmail.to/api-reference/threads/list.mdx)
- API Reference > Threads [Get Thread](https://docs.agentmail.to/api-reference/threads/get.mdx)
- API Reference > Threads [Get Attachment](https://docs.agentmail.to/api-reference/threads/get-attachment.mdx)
- API Reference > Threads [Update Thread](https://docs.agentmail.to/api-reference/threads/update.mdx)
- API Reference > Threads [Delete Thread](https://docs.agentmail.to/api-reference/threads/delete.mdx)
- API Reference > Drafts [List Drafts](https://docs.agentmail.to/api-reference/drafts/list.mdx)
- API Reference > Drafts [Get Draft](https://docs.agentmail.to/api-reference/drafts/get.mdx)
- API Reference > Drafts [Get Attachment](https://docs.agentmail.to/api-reference/drafts/get-attachment.mdx)
- API Reference > Webhooks [List Webhooks](https://docs.agentmail.to/api-reference/webhooks/list.mdx)
- API Reference > Webhooks [Get Webhook](https://docs.agentmail.to/api-reference/webhooks/get.mdx)
- API Reference > Webhooks [Create Webhook](https://docs.agentmail.to/api-reference/webhooks/create.mdx)
- API Reference > Webhooks [Update Webhook](https://docs.agentmail.to/api-reference/webhooks/update.mdx)
- API Reference > Webhooks [Delete Webhook](https://docs.agentmail.to/api-reference/webhooks/delete.mdx)
- API Reference > Webhooks > Events [Message Received](https://docs.agentmail.to/api-reference/webhooks/events/message-received.mdx)
- API Reference > Webhooks > Events [Message Sent](https://docs.agentmail.to/api-reference/webhooks/events/message-sent.mdx)
- API Reference > Webhooks > Events [Message Delivered](https://docs.agentmail.to/api-reference/webhooks/events/message-delivered.mdx)
- API Reference > Webhooks > Events [Message Bounced](https://docs.agentmail.to/api-reference/webhooks/events/message-bounced.mdx)
- API Reference > Webhooks > Events [Message Complained](https://docs.agentmail.to/api-reference/webhooks/events/message-complained.mdx)
- API Reference > Webhooks > Events [Message Rejected](https://docs.agentmail.to/api-reference/webhooks/events/message-rejected.mdx)
- API Reference > Webhooks > Events [Domain Verified](https://docs.agentmail.to/api-reference/webhooks/events/domain-verified.mdx)
- API Reference > Websockets [Connect](https://docs.agentmail.to/api-reference/websockets/websockets.mdx)
- API Reference > Domains [List Domains](https://docs.agentmail.to/api-reference/domains/list.mdx)
- API Reference > Domains [Get Domain](https://docs.agentmail.to/api-reference/domains/get.mdx)
- API Reference > Domains [Get Zone File](https://docs.agentmail.to/api-reference/domains/get-zone-file.mdx)
- API Reference > Domains [Create Domain](https://docs.agentmail.to/api-reference/domains/create.mdx)
- API Reference > Domains [Update Domain](https://docs.agentmail.to/api-reference/domains/update.mdx)
- API Reference > Domains [Delete Domain](https://docs.agentmail.to/api-reference/domains/delete.mdx)
- API Reference > Domains [Verify Domain](https://docs.agentmail.to/api-reference/domains/verify.mdx)
- API Reference > Lists [List Entries](https://docs.agentmail.to/api-reference/lists/list.mdx)
- API Reference > Lists [Get List Entry](https://docs.agentmail.to/api-reference/lists/get.mdx)
- API Reference > Lists [Create List Entry](https://docs.agentmail.to/api-reference/lists/create.mdx)
- API Reference > Lists [Delete List Entry](https://docs.agentmail.to/api-reference/lists/delete.mdx)
- API Reference > Metrics [Query Metrics](https://docs.agentmail.to/api-reference/metrics/query.mdx)
- API Reference > API Keys [List API Keys](https://docs.agentmail.to/api-reference/api-keys/list.mdx)
- API Reference > API Keys [Create API Key](https://docs.agentmail.to/api-reference/api-keys/create.mdx)
- API Reference > API Keys [Delete API Key](https://docs.agentmail.to/api-reference/api-keys/delete.mdx)
- API Reference > Pods [List Pods](https://docs.agentmail.to/api-reference/pods/list.mdx)
- API Reference > Pods [Get Pod](https://docs.agentmail.to/api-reference/pods/get.mdx)
- API Reference > Pods [Create Pod](https://docs.agentmail.to/api-reference/pods/create.mdx)
- API Reference > Pods [Delete Pod](https://docs.agentmail.to/api-reference/pods/delete.mdx)
- API Reference > Pods > Inboxes [List Inboxes](https://docs.agentmail.to/api-reference/pods/inboxes/list.mdx)
- API Reference > Pods > Inboxes [Get Inbox](https://docs.agentmail.to/api-reference/pods/inboxes/get.mdx)
- API Reference > Pods > Inboxes [Create Inbox](https://docs.agentmail.to/api-reference/pods/inboxes/create.mdx)
- API Reference > Pods > Inboxes [Update Inbox](https://docs.agentmail.to/api-reference/pods/inboxes/update.mdx)
- API Reference > Pods > Inboxes [Delete Inbox](https://docs.agentmail.to/api-reference/pods/inboxes/delete.mdx)
- API Reference > Pods > Threads [List Threads](https://docs.agentmail.to/api-reference/pods/threads/list.mdx)
- API Reference > Pods > Threads [Get Thread](https://docs.agentmail.to/api-reference/pods/threads/get.mdx)
- API Reference > Pods > Threads [Get Attachment](https://docs.agentmail.to/api-reference/pods/threads/get-attachment.mdx)
- API Reference > Pods > Threads [Update Thread](https://docs.agentmail.to/api-reference/pods/threads/update.mdx)
- API Reference > Pods > Threads [Delete Thread](https://docs.agentmail.to/api-reference/pods/threads/delete.mdx)
- API Reference > Pods > Drafts [List Drafts](https://docs.agentmail.to/api-reference/pods/drafts/list.mdx)
- API Reference > Pods > Drafts [Get Draft](https://docs.agentmail.to/api-reference/pods/drafts/get.mdx)
- API Reference > Pods > Drafts [Get Attachment](https://docs.agentmail.to/api-reference/pods/drafts/get-attachment.mdx)
- API Reference > Pods > Domains [List Domains](https://docs.agentmail.to/api-reference/pods/domains/list.mdx)
- API Reference > Pods > Domains [Get Domain](https://docs.agentmail.to/api-reference/pods/domains/get.mdx)
- API Reference > Pods > Domains [Get Zone File](https://docs.agentmail.to/api-reference/pods/domains/get-zone-file.mdx)
- API Reference > Pods > Domains [Create Domain](https://docs.agentmail.to/api-reference/pods/domains/create.mdx)
- API Reference > Pods > Domains [Update Domain](https://docs.agentmail.to/api-reference/pods/domains/update.mdx)
- API Reference > Pods > Domains [Delete Domain](https://docs.agentmail.to/api-reference/pods/domains/delete.mdx)
- API Reference > Pods > Domains [Verify Domain](https://docs.agentmail.to/api-reference/pods/domains/verify.mdx)
- API Reference > Pods > Lists [List Entries](https://docs.agentmail.to/api-reference/pods/lists/list.mdx)
- API Reference > Pods > Lists [Get List Entry](https://docs.agentmail.to/api-reference/pods/lists/get.mdx)
- API Reference > Pods > Lists [Create List Entry](https://docs.agentmail.to/api-reference/pods/lists/create.mdx)
- API Reference > Pods > Lists [Delete List Entry](https://docs.agentmail.to/api-reference/pods/lists/delete.mdx)
- API Reference > Pods > Metrics [Query Metrics](https://docs.agentmail.to/api-reference/pods/metrics/query.mdx)
- API Reference > Pods > API Keys [List API Keys](https://docs.agentmail.to/api-reference/pods/api-keys/list.mdx)
- API Reference > Pods > API Keys [Create API Key](https://docs.agentmail.to/api-reference/pods/api-keys/create.mdx)
- API Reference > Pods > API Keys [Delete API Key](https://docs.agentmail.to/api-reference/pods/api-keys/delete.mdx)
- API Reference > Organizations [Get Organization](https://docs.agentmail.to/api-reference/organizations/get.mdx)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.agentmail.to/openapi.json)
- [OpenAPI YAML](https://docs.agentmail.to/openapi.yaml)