Documentation
Idempotency
Safe retries, conflict handling and delivery ambiguity.
Send an Idempotency-Key header with every message. Replaying the same key and identical body returns the original message id with"idempotent": true. Reusing a key with a different body returns 409 idempotency_conflict.
SMTP cannot guarantee exactly-once delivery. We reconcile uncertain submit outcomes before retry, but ambiguous network failures may still produce duplicates. Design receivers to be idempotent.
Need the full API surface? OpenAPI 3.1.