Domain Management

Verify custom sending domains to improve deliverability and establish sender identity.

Add a Domain

curl -X POST https://api-dispatch.techtranslab.com/api/v1/domains \
  -H "Authorization: Bearer your-jwt" \
  -d '{"domain": "mail.yourdomain.com"}'

Verify Domain

After adding a domain, you'll receive DNS records to configure:

# Get required DNS records
curl https://api-dispatch.techtranslab.com/api/v1/domains/{id}/dns-records \
  -H "Authorization: Bearer your-jwt"

Configure these records at your DNS provider:

Type	Name	Purpose
TXT	_dmarc.yourdomain.com	DMARC policy
TXT	yourdomain.com	SPF record
CNAME	selector._domainkey.yourdomain.com	DKIM signing

Then trigger verification:

curl -X POST https://api-dispatch.techtranslab.com/api/v1/domains/{id}/verify \
  -H "Authorization: Bearer your-jwt"

Verification runs automatically in the background, retrying up to 15 times over ~72 hours.

Domain Connect

For supported DNS providers, use Domain Connect for one-click setup:

GET /api/v1/domains/domain-connect/callback?domain=yourdomain.com

This automatically configures DKIM, SPF, and DMARC records.

Warmup & Reputation

New domains start with a warmup period to build sender reputation:

• Daily sending limits increase gradually during warmup
• Reputation score (0-100) tracks domain health
• The system automatically adjusts limits based on bounce rates and complaints

Domain Status

Status	Description
pending	DNS records not yet verified
verified	DNS records confirmed
warming	In warmup period (limited sending)
active	Fully operational
suspended	Suspended due to reputation issues