Developer Documentation

DNS Verification

DNS setup and verification for root domains and subdomains.

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

Provision a domain

Request Example

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:

Request Example

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.

Record types

Mails.now typically returns:

  • MX — inbound mail routing target
  • TXT — domain verification token
  • A — mail-host address for SMTP/IMAP routing

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

Verify in the dashboard

  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.

SPF, DKIM, and DMARC

Mails.now 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