Rotate a Subscription Secret
Webhook Subscriptions
Rotate a Subscription Secret
Generate a new signing secret for a subscription. The new secret is returned only in this response — store it now. The previous secret keeps verifying for a short grace window so in-flight deliveries signed with it still validate.
POST
Rotate a Subscription Secret
Authorizations
AWS Cognito access token obtained from the /authentication endpoint. Token expires after 3600 seconds.
Path Parameters
Response
Secret rotated — new secret included here only
Example:
42
Example:
6042
Example:
"https://hooks.yourapp.com/coverwhale"
Example:
Example:
true
The new signing secret — shown only here.
Example:
"whsec_3a8f5d2c9e1b..."
Example:
"2026-07-14T13:00:00+00:00"
Example:
"2026-07-14T12:00:00+00:00"
Example:
"2026-07-14T13:00:00+00:00"