For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
contact@agentmail.ccDiscord
DocumentationAPI ReferenceKnowledge BaseChangelog
DocumentationAPI ReferenceKnowledge BaseChangelog
    • Introduction
  • Getting Started
    • What is AgentMail?
    • What can I do with an inbox?
    • Creating your first inbox
    • Getting your API key
  • Agent Patterns
    • Handling inbound emails
    • Allowlists & blocklists
    • Managing threaded conversations
    • Human-in-the-loop workflows
    • Pods for multi-tenant email
    • Using labels to track state
  • Domains & Deliverability
    • Custom domain setup
    • SPF, DKIM, and DMARC setup
    • Emails going to spam
    • Warming Up
    • MX record conflicts
  • Troubleshooting
    • API 403 error
    • Rate limits
    • Preventing duplicate sends
    • Domain not verifying
    • Emails bouncing
    • Why are my emails not showing up?
  • DNS Guides
    • Cloudflare
    • GoDaddy
    • Route 53 (AWS)
    • Namecheap
LogoLogo
contact@agentmail.ccDiscord
On this page
  • Getting Started
  • Agent Patterns
  • Domains & Deliverability
  • Troubleshooting
  • DNS Guides

Knowledge Base

A collection of answers to frequently asked questions.
Was this page helpful?
Edit this page

What is AgentMail and how is it different?

Understand how AgentMail compares to traditional email providers.
Next
Built with

Getting Started

What is AgentMail?

How AgentMail compares to Resend, SendGrid, and other email providers.

What can I do with an inbox?

CC, BCC, forwarding, threading, attachments, labels, IMAP, and more.

Creating your first inbox

Get up and running with your first AgentMail inbox.

Getting your API key

How to create and manage your API keys.

Agent Patterns

Handling inbound emails

Webhooks vs WebSockets vs polling for receiving emails.

Allowlists & blocklists

Control who can send to and receive from your inboxes.

Managing threaded conversations

Build agents that maintain context across email threads.

Human-in-the-loop workflows

Add human review and approval steps to your agent workflows.

Pods for multi-tenant email

Isolate inboxes and data across tenants with Pods.

Using labels to track state

Use labels to manage agent workflow state on emails.

Domains & Deliverability

Custom domain setup

Send emails from your own domain instead of @agentmail.to.

SPF, DKIM, and DMARC setup

Authenticate your domain for better deliverability.

Emails going to spam

Troubleshoot and fix spam folder placement issues.

Domain warming schedule

Gradually build sending reputation on a new domain.

MX record conflicts

Add AgentMail DNS records without breaking existing email.

Warming up your inbox

Connect to third-party warm-up tools before running cold outbound.

Troubleshooting

Rate limits

Understand AgentMail’s rate limits and how to work within them.

Preventing duplicate sends

Use idempotency to avoid sending the same email twice.

Domain not verifying

What to do when your domain verification is stuck.

Emails bouncing

Diagnose and resolve email bounce issues.

Email spoofing protection

How AgentMail protects your inboxes from unauthenticated senders.

DNS Guides

Step-by-step instructions for verifying your domain with popular DNS providers.

Cloudflare DNS Guide

Configure AgentMail DNS records in Cloudflare.

GoDaddy DNS Guide

Configure AgentMail DNS records in GoDaddy.

Route 53 DNS Guide

Configure AgentMail DNS records in AWS Route 53.

Namecheap DNS Guide

Configure AgentMail DNS records in Namecheap.