Rotate a webhook endpoint secret
Generates a new signing secret for the endpoint and returns it. The response is the only time the new secret appears in plaintext — store it securely.
To avoid dropping deliveries mid-rollout, the previous secret keeps verifying until the overlap window closes (the endpoint’s previous_secret_expires_at). During the window every delivery is signed with both secrets, so the X-Kit-Signature header carries two v1 entries — see secret rotation.
Rotating again while a previous rotation’s window is still open returns 409; pass force: true to rotate anyway and immediately expire the older secret. Once you’ve switched over, you can close the window early with Revoke the previous secret.
Authorizations
Authenticate API requests via an API Key
Path Parameters
Body
Rotating again while a previous rotation's overlap window is still open returns 409 (see the responses below). Pass true to rotate anyway, immediately expiring the older secret.
Response
Rotates the secret and returns the new one
Related topics
Get a webhook endpointCreate a webhook endpointRevoke the previous webhook endpoint secretVerifying signaturesUpgrading to V4