Skip to main content
POST
Regenerate Secret

Path Parameters

string
required
The unique identifier of the webhook endpoint.

Response

boolean
Indicates if a new secret was generated.
string
The endpoint the secret belongs to.
string
The new signing secret (64 hexadecimal characters). Store this securely. It is only returned once.

Behavior

  • The old secret stops working immediately. Update the receiving system with the new secret straight away, or its signature checks fail until you do.
  • Deliveries that are being retried are signed with the new secret.
  • In the dashboard the same action is the Regenerate Secret button on the Review step of an existing webhook under Connecter > Webhooks.
This endpoint requires JWT authentication (the login token of a dashboard user), not an okt_ API token.