Skip to main content

Webhooks

Signed HTTPS notifications for platform events: endpoints, deliveries, test events, redelivery and secret rotation.

📄️ Issue a new signing secret; the previous one keeps signing for 24 h

At most two secrets are live. While the previous secret is still in its 24-hour overlap the call answers 409 `secret_rotation_in_progress` (`details.previous_secret_expires_at`), unless you send `expire_previous_now: true`: the older secret is then destroyed at once and the current one becomes the previous one (the way back after a lost rotation response). No `Idempotency-Key` replay: secrets are never stored in a replayable form.