Guides
Email sending domain
DNS records, DKIM and warm-up for the domain your email is sent from.
Email goes out through Amazon SES in the Jakarta region, from a domain you control. Mail from your own domain builds your own reputation and keeps it apart from other senders.
DNS records#
For a domain such as mail.example.com:
| Type | Name | Purpose |
|---|---|---|
| CNAME (three) | <token>._domainkey | DKIM. Each points at <token>.dkim.ap-southeast-3.amazonses.com. |
| MX | bounce | The custom MAIL FROM host: 10 feedback-smtp.ap-southeast-3.amazonses.com. |
| TXT | bounce | SPF for the MAIL FROM host: v=spf1 include:amazonses.com ~all. |
| TXT | _dmarc | Your DMARC policy, for example v=DMARC1; p=none; rua=mailto:dmarc@example.com. Start at p=none and tighten after two clean weeks. |
The DKIM CNAMEs must point at the regional dkim.ap-southeast-3.amazonses.com, not the global dkim.amazonses.com. Some DNS hosts append your zone name to a target that lacks a trailing dot. If DKIM stays PENDING after 72 hours, compare the records against the values you were given.
Check from public resolvers, not your provider's own name servers:
dig @8.8.8.8 CNAME <token>._domainkey.mail.example.com +short
dig @1.1.1.1 MX bounce.mail.example.com +shortWhat a sender looks like#
- A marketplace store sends from
<local part>@<domain>, with the display name<Store name> via <Marketplace>. A local part is 3 to 40 lowercase letters and digits. Set it withPUT /v1/scopes/{id}/email-sender. A taken one is409 local_part_taken. - A workspace's own email uses the domain's default From address and name.
- Reply-To is set per domain.
Every marketing email can be unsubscribed from#
Each marketing email has List-Unsubscribe with a mailto and a one-click URL, and List-Unsubscribe-Post: List-Unsubscribe=One-Click. A message without a way to unsubscribe is never sent.
Warm-up#
A new domain has no reputation, so Sapagan ramps it up. The default ramp has 20 stages: 100 emails a day, then at most 1.5 times more each step, 3 sending days per stage, up to 200,000 a day. That is about 60 sending days to full volume.
- Engaged recipients (an open or click in the last 30 days) go first.
- Marketing over the day's allowance waits for the next day. It is deferred, not dropped.
- Transactional email is always sent at once. It counts toward the day.
- A domain pauses when, with at least 100 sends in 24 hours, complaints pass 0.3 percent or hard bounces pass 5 percent. Only a Sapagan platform operator resumes it.
- A day with a spam rate above 0.10 percent (from Google Postmaster Tools) holds the ramp. Two bad days in a row roll it back one stage.
Read results with GET /v1/email/deliverability. deferredByWarmup appears in a broadcast's stats.
Bounces and complaints#
SES feedback arrives automatically. A permanent bounce or a complaint adds the address to the suppression list, and a complaint also revokes that store's marketing consent for the person. GET /v1/suppressions lists them with masked addresses. Alerts fire above a 2 percent hard bounce rate or a 0.08 percent complaint rate over 24 hours with at least 500 sends.
Set the workspace's test recipients and footer line with PUT /v1/workspace/email-settings.