Domains
Retransmit only sends email from domains that are registered on your account and verified. This protects deliverability and proves you own the domain you send from.
Adding a domain
- Open the dashboard and go to Domains.
- Add your domain (e.g.
yourdomain.com). - Publish the DNS records shown (SPF / DKIM) at your DNS provider.
- Wait for verification to complete.
Domain statuses
| Status | Meaning |
|---|---|
pending | DNS records not yet detected. Propagation can take up to 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. |
What happens if the domain isn’t ready
Requests to POST /v1/emails are rejected before anything is sent:
- The
fromdomain is not on your account →403with error codedomain_not_found. - The domain exists but isn’t
verified→403with error codedomain_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
The from field accepts either a bare address (hello@yourdomain.com) or a
display name form (Acme <hello@yourdomain.com>). The domain is extracted
from the address part.
Last updated on