DNS setup

agentinbox.pro requires two DNS records on a domain you control. Both are returned when you register the domain via the API.

Production MX target: mx.agentinbox.pro (priority 10).

Records at a glance

Step	Type	Name / Host	Value
Ownership	TXT	`_agentmail-verify.<domain>`	`agentmail_verify_...` from API
Routing	MX	`<domain>` (or `@`)	`mx.agentinbox.pro` priority 10

Example for acme-agent.com:

TXT  _agentmail-verify.acme-agent.com  →  agentmail_verify_abc123...
MX   acme-agent.com                    →  10 mx.agentinbox.pro

Order of operations

1. POST /api/domains          → get TXT name + value
2. Add TXT at DNS provider
3. POST /api/domains/:id/verify
4. Add MX at DNS provider
5. PATCH /api/domains/:id/delivery
6. Send test mail

TXT must pass before verify succeeds. MX can be added before or after verify; mail will not route until MX propagates.

Registrar notes

Cloudflare

TXT: set Name to _agentmail-verify (Cloudflare appends the zone name).
MX: Name @, Mail server mx.agentinbox.pro, Priority 10.
Proxy status does not affect MX/TXT — leave DNS-only (grey cloud) if unsure.

Porkbun

DNS → Add Record → TXT: Host _agentmail-verify, Answer = full verify string.
MX: Host blank or @, Answer mx.agentinbox.pro, Priority 10.

Route 53

Create TXT record set on _agentmail-verify.acme-agent.com.
Create MX record set on acme-agent.com with value 10 mx.agentinbox.pro.

Propagation

DNS changes can take minutes to hours. If verify fails with 409 Conflict, wait and retry:

curl -s -X POST "$API/api/domains/$DOMAIN_ID/verify" \
  -H "Authorization: Bearer $AGENTMAIL_API_KEY"

Check TXT manually:

dig TXT _agentmail-verify.acme-agent.com +short

Check MX:

dig MX acme-agent.com +short
# expect: 10 mx.agentinbox.pro.

Address model

You do not register individual addresses. Once the domain is verified and MX points at agentinbox.pro, every address on that domain is accepted:

billing@acme-agent.com   ✓
anything@acme-agent.com  ✓

Tenant resolution happens at SMTP RCPT TO from the recipient domain.

Eligible domain statuses for SMTP

agentinbox.pro accepts inbound mail when domain status is one of:

verified | mx_pending | live

Statuses like pending_verification or disabled are rejected at SMTP.