Introducing Domain Connect

Your agents deserve their own email address. Setting one up shouldn't be the hard part.

Today, we're introducing Automatic Domain Setup, powered by Domain Connect and launched in partnership with Vercel and Cloudflare. Add a custom domain to AgentMail, click Set up with Vercel or Set up with Cloudflare, approve the DNS changes with your provider, and come back to AgentMail for verification. There are no DNS records to copy by hand. The same flow is available through the API, so an agent can start the setup itself and a person only has to approve it.

One of the things we've always believed at AgentMail is that AI agents should be first-class citizens on the internet. That means having their own identities, their own inboxes, and the ability to communicate with the outside world.

Increasingly, developers want those identities to live on their own domains. Until now, getting an agent set up with a custom email domain has been more complicated than it needed to be.

Why is setting up a custom email domain so frustrating?

Setting up a custom domain meant moving back and forth between AgentMail and your DNS provider, copying records by hand, and waiting for verification. That's five DNS records, verification checks that back off exponentially and stretch out the wait, and many points of failure.

In fact, 42.1% of new customers who added a custom domain in the past month encountered at least one verification failure.

Sometimes it was a missing character. Other times it was a duplicated domain suffix, or a record entered in the wrong place.

These failures come from copying and pasting records manually, and every DNS provider has its own interface for entering them. A small mistake could turn what should have been a quick setup into a frustrating debugging session.

We wanted to change that.

How does one-click domain setup work?

We've partnered with Vercel and Cloudflare to make connecting your custom domain to AgentMail much simpler. Instead of copying DNS records, you connect your domain directly through your DNS provider:

1. Add your custom domain to AgentMail.
2. Click Set up with Vercel or Set up with Cloudflare.
3. Review and approve the DNS changes with your provider.
4. Return to AgentMail for verification.

That's the whole flow. There's no back and forth between tabs and no records to copy and paste.

Can an agent set up a custom domain through the API?

Yes. We didn't want this to stop at the console, so Automatic Domain Setup is available through the API as well.

Your agent can create a domain, request a configuration link, and start the setup process without a developer assembling DNS records:

# 1. Create the domain
curl -s -X POST "https://api.agentmail.to/v0/domains" \
  -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

# 2. Request a setup link for it, using the domain_id from step 1
curl -s "https://api.agentmail.to/v0/domains/$DOMAIN_ID/setup-link" \
  -H "Authorization: Bearer $AGENTMAIL_API_KEY"

When the domain's DNS provider supports it, the response looks like this:

{
  "supported": true,
  "provider_name": "Cloudflare",
  "url": "https://...",
  "state": "..."
}

Open url for the domain owner to approve, and store state first so you can check it when the provider redirects back. If the provider isn't supported, supported comes back false and the records can be added manually. The setup link reference covers every field, including the popup size and the warning returned when the domain already has another email provider's MX records.

The domain owner still reviews and authorizes the changes with their DNS provider, but the rest of the workflow can be orchestrated programmatically.

How does Domain Connect work under the hood?

Automatic Domain Setup is powered by Domain Connect, an open standard for simplifying DNS configuration.

AgentMail generates the records required for email delivery and authentication, then passes them to your DNS provider through a signed configuration link. The provider presents the proposed changes for approval before applying them. Because the link is signed, the provider knows the records came from AgentMail and weren't edited along the way.

What does it not cover yet?

Automatic Domain Setup works today for domains whose DNS is hosted on Vercel or Cloudflare. Domains on other providers still use the manual flow in the custom domains guide, and we're adding more providers.

It also doesn't remove the approval step. Someone with access to the DNS account has to approve the changes, which keeps a person in control of what gets written to the domain. Custom domains are available on paid plans, as listed on the pricing page.

What does this mean for agents?

We're working toward a future where developers can give agents everything they need to operate independently: identities, inboxes, authentication, and the ability to communicate with people and services.

That future requires making infrastructure that was designed for humans easier for agents to use. Custom domain configuration is one small but important piece of that. If you're running many agents across many domains, how to manage custom domains for thousands of agent inboxes covers which agents should share a domain and which should get their own.

With Automatic Domain Setup, developers can spend less time configuring email infrastructure and more time building what their agents can do.

It's available today for domains using Vercel and Cloudflare, with more providers coming soon. Try it in the AgentMail console.