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.