Verify Sending Domain

Verify DNS configuration for a sending domain.

Use Cases:

• Check if DNS records have been configured correctly
• Verify domain readiness after DNS propagation
• Diagnose DNS configuration issues
• Re-verify after making DNS changes
• Confirm domain is ready for email sending

Behavior:

• Performs live DNS lookups for all required records
• Checks DKIM, return path, tracking, and optionally DMARC records
• Updates domain verification status based on results
• Returns detailed verification results for each record
• Triggers SSL certificate issuance when tracking is verified
• Can be called multiple times (idempotent)

Required Scope: update:domains

Verification Checks:

• DKIM: Verifies TXT record for email authentication
• Return Path: Verifies CNAME record for bounce handling
• Tracking: Verifies CNAME record for open/click tracking
• DMARC: Verifies DMARC policy record (if enabled)
• MX: Optionally checks MX records

Response Includes:

• Updated domain details with current verification status
• Per-record verification results (configured, expected value, found values)
• Overall allVerified flag

Note: DNS propagation can take up to 48 hours. If verification fails, wait and retry.