1 minute readFixedAgent-ready
Rotate webhook signing secrets, and tokens end with their key
Webhook signing secrets have their own rotate route, and a token stops working when the key it came from is revoked or rotated.
POST /api/webhooks/{webhookId}/rotate-secretreturns a new signing secret once. Update your receiver: later deliveries are signed with it.- Webhook records read with a key or token show the signing secret masked.
- Tokens tied to a key are refused once that key is revoked or rotated. Tokens issued before this change last until they expire.
DELETE /api/me/keyrevokes the key you call it with.
Verify signatures over the raw body and use event ids to drop duplicates. The timestamp header is not part of the signature.