Rotate the signing secret

POST

/webhooks/{id}/rotate-secret

Webhook Endpoints

Last modified:2026-06-03 19:01:51

Maintainer:Not configured

Generates a new signing secret for the endpoint. The new secret is returned once only — store it immediately. All future deliveries will be signed with the new secret.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200

application/json

New secret generated.

Bodyapplication/json

🟠401Unauthorized

🟠404NotFound

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/webhooks//rotate-secret' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "secret": "nEwSeCrEtAbCdEfGhIjKlMnOpQrStUvWxYz01234567890123456789012345",
    "notice": "Store the new secret securely — it will not be shown again."
}

Modified at 2026-06-03 19:01:51

Delete a webhook endpoint

Send a test event