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):
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.
TypeScript SDK 3.23.0 Added
Section titled “TypeScript SDK 3.23.0 ”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.