SapaganDocs sapagan.com

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:

TypeNamePurpose
CNAME (three)<token>._domainkeyDKIM. Each points at <token>.dkim.ap-southeast-3.amazonses.com.
MXbounceThe custom MAIL FROM host: 10 feedback-smtp.ap-southeast-3.amazonses.com.
TXTbounceSPF for the MAIL FROM host: v=spf1 include:amazonses.com ~all.
TXT_dmarcYour 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 +short

What 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 with PUT /v1/scopes/{id}/email-sender. A taken one is 409 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.