Skip to main content
POST
Rotate the signing secret

Authorizations

Authorization
string
header
required

HTTP Basic Authentication. Use your API Access Key ID as the username and your API Access Key Secret as the password. Generate keys in the CloudTalk Dashboard under Account -> Settings -> API Keys (https://dashboard.cloudtalk.io/menu/account/settings/API-keys).

Path Parameters

endpointId
string
required

Webhook endpoint id (ep_...).

Example:

"ep_2nJ4qKZr8C1tY0dXwV3uFh7bM9s"

Response

The new secret, and when the previous one stops signing.

secret
string
required

The new signing secret.

Example:

"whsec_EXAMPLE_NEW_SIGNING_SECRET"

previousSecretExpiresAt
string<date-time>
required

When the previous secret stops signing deliveries: 24 hours after the rotation. Until then every delivery carries signatures from both secrets.

Example:

"2026-10-15T09:30:12Z"