Domains

Verify your sending domain for better email deliverability.

Why verify your domain?

Domain verification proves you own the domain you're sending from. This improves deliverability and prevents your emails from being marked as spam.

  • Higher inbox placement rates
  • Better sender reputation
  • Required for sending from custom domains
  • Enables DKIM signing for authentication

Adding a domain

Add a domain via the API or dashboard:

// POST /api/domains
{
    "name": "yourdomain.com"
}

Response includes DNS records to add:

{
    "success": true,
    "data": {
        "id": "dom_abc123",
        "name": "yourdomain.com",
        "status": "pending",
        "records": [
            {
                "type": "TXT",
                "name": "sentd._domainkey",
                "value": "v=DKIM1; k=rsa; p=MIGf..."
            },
            {
                "type": "TXT",
                "name": "_dmarc",
                "value": "v=DMARC1; p=none"
            }
        ]
    }
}

DNS records to add

Add these records in your DNS provider (Cloudflare, Route53, etc.):

TypeNamePurpose
TXTsentd._domainkeyDKIM signature
TXT_dmarcDMARC policy
TXT@SPF record (optional)

Verifying the domain

After adding DNS records, verify the domain:

// POST /api/domains/:id/verify

// Response
{
    "success": true,
    "data": {
        "id": "dom_abc123",
        "name": "yourdomain.com",
        "status": "verified",
        "verified_at": "2024-01-15T10:30:00Z"
    }
}

DNS propagation can take up to 48 hours. If verification fails, wait and try again.