Skip to Content

Idempotency

Callers may pass optional idempotencyKey on POST /notifications (maximum 200 characters).

Contract

  • Deduplication key is (source, idempotencyKey)
  • A repeated request with the same pair returns the original request and delivery IDs
  • Recipients are not sent again for that key pair

Use this when upstream strategies retry HTTP calls after timeouts or restarts.

source is always required on the request body. Without idempotencyKey, each POST creates a new request and new deliveries.

Last updated on