DNS Verification

Before MailAPI can route mail for a domain, publish the DNS records returned by domain provisioning and verify them in the dashboard or via API polling.

curl --fail-with-body --silent --show-error \
  -X POST "$APP_URL/api/v1/create/domain" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "Domain": "example.com",
    "Params": {
      "total_mailbox_allowed": 100
    }
  }'

Poll the task until status is completed:

curl -H "Authorization: Bearer $API_KEY" \
  "$APP_URL/api/v1/get/domain?task_id=101"

When complete, the response includes DNS records for your domain.

MailAPI typically returns:

• check_circleMX — inbound mail routing target
• check_circleTXT — domain verification token
• check_circleA — mail-host address for SMTP/IMAP routing

Add these records at your DNS host exactly as returned by the API.

1. Open the domain in Domains.
2. Publish the returned records at your DNS provider.
3. Click Verify DNS after propagation.

Root domains generally require MX, TXT, and mail-host A checks. Subdomains may require MX verification only.

MailAPI provides MX and mail-host records for routing. Configure SPF, DKIM, and DMARC with your outbound SMTP provider separately to improve deliverability.

Next steps: Getting started · API docs