Factuarea APIDevelopers

webhook_secret_recently_rotated

The signing secret was rotated less than five minutes ago. The grace window lets your receiver accept both secrets during the switch; rotating again inside it would invalidate signatures still in flight. It answers as a 422 `business_rule_violation` with `error.subcode` `webhook_secret_recently_rotated`; it is not a request limit and consumes no rate-limit bucket.

CodeTypeHTTPCategory
webhook_secret_recently_rotatedinvalid_request_error422Webhooks

Cause

The signing secret was rotated less than five minutes ago. The grace window lets your receiver accept both secrets during the switch; rotating again inside it would invalidate signatures still in flight. It answers as a 422 business_rule_violation with error.subcode webhook_secret_recently_rotated; it is not a request limit and consumes no rate-limit bucket.

What to do

Wait five minutes from the last rotation, and deploy the new secret in your receiver before rotating again.

On this page

Need a hand?Contact support