Create a domain

POST /domains

Add a new sending domain. 3AVA Mail generates a DKIM keypair and returns the DNS records you need to add. The domain starts in pending status until you call POST /domains/:id/verify.

Body parameters

Field	Type	Required	Description
name	string	yes	FQDN (e.g. mail.acme.com).
region	string	no	Default us-east-1.
pool_group_id	uuid	no	Restrict sends from this domain to a specific IP pool.

Example

cURL

curl -X POST https://mail.3ava.com/api/domains \
  -H "Authorization: Bearer am_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "mail.acme.com"}'

Response

{
  "id": "dom_a1b2...",
  "name": "mail.acme.com",
  "status": "pending",
  "region": "us-east-1",
  "dkim_selector": "amdy20260422",
  "dns_records": [
    {
      "type": "TXT",
      "name": "mail.acme.com",
      "value": "v=spf1 include:_spf.3ava.com ~all",
      "purpose": "spf",
      "required": true
    },
    {
      "type": "TXT",
      "name": "amdy20260422._domainkey.mail.acme.com",
      "value": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhki...",
      "purpose": "dkim",
      "required": true
    },
    {
      "type": "TXT",
      "name": "_dmarc.mail.acme.com",
      "value": "v=DMARC1; p=quarantine; rua=mailto:[email protected]",
      "purpose": "dmarc",
      "required": true
    },
    {
      "type": "MX",
      "name": "mail.acme.com",
      "value": "10 inbound.3ava.com",
      "purpose": "mx",
      "required": false
    }
  ],
  "created_at": "2026-04-22T22:30:00Z"
}

Add the records with your DNS provider, wait for propagation (usually 5–10 min), then call verify.