Skip to main content
POST
/
v1
/
webhooks
/
{id}
/
rotate-secret
Rotate the signing secret for a webhook endpoint
curl --request POST \
  --url https://api.example.com/v1/webhooks/{id}/rotate-secret \
  --header 'Authorization: Bearer <token>'
{
  "createdAt": "<string>",
  "enabled": true,
  "events": [],
  "id": "<string>",
  "signingSecret": "whsec_a1b2c3d4e5f6...",
  "signingSecretHint": "ab1f",
  "updatedAt": "<string>",
  "url": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.zuba.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Enter Auth0 JWT token

Path Parameters

​
id
string<uuid>
required

Webhook endpoint ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

Response

New signing secret. Shown only once.

​
createdAt
string
required

Creation timestamp

​
enabled
boolean
required

Whether the endpoint is enabled

​
events
enum<string>[]
required

Subscribed event types

Available options:
payout.processing,
payout.paid,
payout.failed,
payout.cancelled,
webhook.test
​
id
string
required

Endpoint ID

​
signingSecret
string
required

Signing secret (plaintext, shown only once). Use this to verify webhook signatures.

Example:

"whsec_a1b2c3d4e5f6..."

​
signingSecretHint
string
required

Last 4 characters of the signing secret

Example:

"ab1f"

​
updatedAt
string
required

Last update timestamp

​
url
string
required

Webhook URL