
Protecting email API keys: scopes, rotation, leak response
An email API key is the power to send as your domain. Scope keys narrowly, store them safely, rotate them on a schedule and respond fast to leaks.
4 min read
Blog · Email API · page 5 of 5
Transactional email engineering: sending APIs, SMTP relays, webhooks, retries, idempotency, templates and testing.

An email API key is the power to send as your domain. Scope keys narrowly, store them safely, rotate them on a schedule and respond fast to leaks.
4 min read

Hard bounces, complaints and unsubscribes each deserve different suppression rules. Design a suppression list, scopes and expiry that protect reputation.
5 min read

Never trust a webhook until you verify its signature over the raw body. HMAC verification in Node, Python and Go, plus timestamp and replay checks.
5 min read

Assert on the message your code builds, not on an inbox. Layered tests for transactional email: rendering units, contract tests and a few end-to-end checks.
5 min read

SMTP relays are universally compatible; HTTP APIs are easier to make idempotent and observable. Compare them on errors, retries, security and speed.
4 min read

One-click unsubscribe needs two headers, a DKIM signature that covers them, and an endpoint that accepts a POST without a login. Build it step by step.
5 min read

Control how notification emails thread in Gmail and Outlook with Message-ID, In-Reply-To and References, and how to break unwanted threads apart.
4 min read

Attaching invoices and reports raises size, security and deliverability concerns. When to attach, when to link, and how to keep attachments safe.
4 min read

Non-ASCII names, subjects and addresses need different mechanisms. How RFC 2047 encoded words, SMTPUTF8 and IDN domains fit together in practice.
4 min read

Reset emails are a top account takeover vector. Design single-use, short-lived tokens, avoid account enumeration and make the email arrive fast.
4 min read

Webhooks arrive late, twice or out of order. Design consumers that acknowledge fast, deduplicate by event, process asynchronously and tolerate disorder.
4 min read

Passwordless login lives or dies on email delivery. Compare magic links and one-time codes on security, link scanners, latency and cross-device use.
5 min read