Using your own domain for agent email addresses looks more professional and avoids the risk of disposable email detectors blocking your agent. Here is how to set up a custom domain with AgentMailr.

Why Use a Custom Domain

  • Some services block disposable email domains like mailinator.com
  • Branded addresses like agent@yourcompany.com build trust with recipients
  • You control the domain reputation
  • SPF, DKIM, and DMARC records apply to your brand, not ours

Step 1: Add the Domain

POST /v1/domains
{
  "domain": "agents.yourcompany.com"
}

Response includes the DNS records you need to add.

Step 2: Add DNS Records

You need three types of records:

  • MX record: Points to AgentMailr's mail server so inbound email works
  • TXT record (SPF): Authorizes AgentMailr to send on your behalf
  • TXT record (DKIM): Cryptographic signing key for outbound email

Add these at your DNS provider (Cloudflare, Route53, etc.).

Step 3: Verify

POST /v1/domains/{id}/verify

AgentMailr checks all DNS records and marks the domain as active if everything is correct. DNS propagation typically takes 5-15 minutes.

Step 4: Create Inboxes

POST /v1/inboxes
{
  "name": "research-agent",
  "domain": "agents.yourcompany.com"
}

Response: { "address": "research-agent@agents.yourcompany.com" }

Subdomains Are Useful

Using a subdomain like agents.yourcompany.com instead of yourcompany.com keeps agent email separate from your main domain's email. This protects your main domain's sender reputation.