Regenerate secret.

POST/api/v1/webhooks/{id}/regenerate-secret

Browse API endpoints

Webhooks / CRM REST API

Scope: webhooks:manage

Regenerates the signing secret for a webhook subscription. The old secret is immediately invalidated.

Response:

Code example

{
  "data": {
    "id": "webhook_subscription_id_here",
    "secret": "whsec_new_plaintext_secret_here"
  }
}

Store the new secret securely - it is shown once. Update your webhook verification code with the new secret immediately.

Loading endpoint details...

Build a request

Request example

Documented defaults and example values are ready. Change only the parameters you need.

Connection

Your CRM deployment URL

Replace the Bearer API key placeholder in the copied server-side code. No API key is entered or sent here.

Sub-account ID Agency keys onlyAgency-scoped keys require the X-Sub-Account-Id header.

Path parameters

id Required

cURL

curl --request POST \
  --url 'https://your-crm.example.com/api/v1/webhooks/ID_HERE/regenerate-secret' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

This shows a static response from the documentation. It does not send a request to your CRM or use an API key.