AgentMail Changelog

Summary

You can now create inboxes on any subdomain of a verified domain without registering each subdomain separately. Enable subdomains_enabled on a domain, publish the single wildcard MX record it returns, and create inboxes on any subdomain on demand. Build agents that spin up addresses like agent@bot.example.com or support@team1.example.com the moment you need them.

What’s new?

New features:

• Subdomains: Opt in per domain with subdomains_enabled. When enabled, the domain’s verification records include a wildcard MX record (*.<domain>) to publish on the top-level domain. Once it is published and verified, inboxes can be created on any subdomain of that domain.

Changes:

• POST /v0/domains accepts an optional subdomains_enabled flag (defaults to false).
• PATCH /v0/domains/:domain_id now accepts subdomains_enabled and applies partial updates: send at least one of feedback_enabled or subdomains_enabled, and omitted fields are left unchanged. Enabling subdomains on an already-verified domain returns it to pending until the new wildcard MX record is published; sending is not interrupted.
• Domain responses now include the subdomains_enabled field.
• Creating an inbox on a subdomain of a domain that does not have subdomains enabled returns a 422 error.

Use cases

Build agents that:

• Provision a dedicated inbox per customer or workspace under one verified domain (support@acme.example.com)
• Separate agent traffic onto purpose-named subdomains (billing., outreach., support.) without registering each one
• Stand up short-lived inboxes on fresh subdomains for one-off tasks, then tear them down
• Keep all agent addresses under a single domain you verify and manage once

1
from agentmail import AgentMail
2
3
client = AgentMail(api_key="your-api-key")
4
5
# Enable subdomains on a verified domain
6
domain = client.domains.update("example.com", subdomains_enabled=True)
7
8
# Publish the new wildcard MX record, then create inboxes on any subdomain
9
inbox = client.inboxes.create(username="agent", domain="bot.example.com")
10
print(inbox.inbox_id)  # agent@bot.example.com