Domains

Retransmit only sends email from domains that are registered on your account and verified.

Adding a domain

Open Domains in the dashboard.
Enter your domain, e.g. yourdomain.com.
Pick the region the domain sends from (see below).
Choose a Return-Path subdomain. The default mail gives mail.yourdomain.com.
Publish the DNS records shown at your DNS provider.
Wait for verification to complete, then check the status from the domain’s details.

Regions

Email is sent out of the region a domain was verified in. The region cannot be changed after the domain is added; delete the domain and add it again to move it.

Region	Location
`eu-central-1`	Frankfurt
`us-east-1`	N. Virginia
`ap-southeast-1`	Singapore
`af-south-1`	Cape Town

Pick the region closest to most of your recipients, or the one your data residency rules require.

Return-Path

The Return-Path is the address bounces and delivery reports go back to. Using a subdomain you control, instead of the provider’s default, aligns SPF with your domain and keeps your DMARC policy intact.

It must be a subdomain of the sending domain. The root domain is not accepted.

DNS records

Record	Name	Purpose	Required
`CNAME` (x3)	`<token>._domainkey.yourdomain.com`	DKIM signing	Yes
`MX`	`mail.yourdomain.com`	Return-Path, routes bounces back to the sending region	Yes
`TXT`	`mail.yourdomain.com`	SPF for the Return-Path (`v=spf1 include:amazonses.com ~all`)	Yes
`TXT`	`_dmarc.yourdomain.com`	DMARC policy	Recommended

The exact values are shown in the dashboard and can be copied one by one.

Domain statuses

Status	Meaning
`pending`	DNS records not yet detected. Propagation can take a few hours.
`verified`	Ready to send.
`failed`	Verification failed. Re-check the DNS records.
`temporary_failure`	Verification hit a transient issue and will be retried.

Sending from an unready domain

POST /v1/emails rejects the request before anything is sent:

Condition	Response
The `from` domain is not on your account	`403 domain_not_found`
The domain exists but is not `verified`	`403 domain_not_verified`. The message includes the current status.


{
  "error": {
    "code": "domain_not_verified",
    "message": "The domain `yourdomain.com` is not verified yet (status: pending)."
  }
}

Tip

from accepts a bare address (hello@yourdomain.com) or a display name form (Acme <hello@yourdomain.com>). The domain is taken from the address.