Skip to content

Rotated webhook signing secrets no longer expire by default

Released: October 30, 2026

Signing secret rotation Changed

Section titled “Signing secret rotation ”

POST /v1/webhook_subscriptions/{id}/secrets now returns a secret with expires_at: null when the request has no expires_in_hours, the same as the initial secret issued with the subscription.

Until now an omitted expires_in_hours defaulted to 72 hours. A rotation that minted a new secret and then revoked the old one therefore stopped every delivery three days later with no_signing_secret.

To issue a temporary secret, keep sending expires_in_hours (1-336):

Terminal window
curl -X POST \
https://api.kirimdev.com/v1/webhook_subscriptions/wbs_.../secrets \
-H "Authorization: Bearer $KIRIM_KEY" \
-H "Content-Type: application/json" \
-d '{"expires_in_hours": 72}'

Secrets issued before this change keep their original expires_at. Check yours with GET /v1/webhook_subscriptions/{id} and mint a new one if an active secret is about to expire.

kirim.webhookSubscriptions.addSecret(id, params?, options?) accepts { expires_in_hours }. Without it the new secret never expires. The previous form addSecret(id, options) still works.