Skip to content
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-secret returns 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/key revokes 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.