Rotate Secret

Rotate the signing secret for a webhook subscription.

Generates a new HMAC signing secret and returns it in plain text. The previous secret is immediately invalidated. Update your webhook handler to use the new secret for signature verification.

Use Cases

  • Rotate secrets as part of regular security hygiene.
  • Generate a new secret if the current one may be compromised.

Important

The new secret is only shown in this response. Subsequent GET requests return a redacted version. Store it securely immediately.

Required scope: webhooks:write