Skip to main content
POST
Rotate webhook signing secret

Authorizations

Authorization
string
header
required

API Key authentication. Format: dk_test_ or dk_live_

Path Parameters

webhook_config_id
string<uuid>
required

Webhook configuration ID

Response

New signing secret (shown only once)

Response for rotating a webhook signing secret.

WARNING: The old signing secret is immediately invalidated. Update your webhook receiver before verifying signatures.

webhook_config_id
string<uuid>
required

Unique webhook configuration identifier

signing_secret
string
required

New webhook signing secret for HMAC verification (SHOWN ONLY IN THIS RESPONSE)

rotated_at
string<date-time>
required

Timestamp when the secret was rotated (ISO 8601)