v44

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-05-192301780.0 KB
Webhooks

Rotate webhook signing secret

Generates a new signing secret for the endpoint. The previous secret remains valid until previousSecretExpiresInSec elapses (default 24h, max 30 days). During the grace window deliveries are signed with both secrets so receivers can migrate without downtime. Returns the new secret — this is the only time it is shown in plaintext.

post/webhooks/v1/endpoints/{id}/rotate_secret

Path parameters

idstring required

Request body

previousSecretExpiresInSecinteger

How long (seconds) the old secret continues to be accepted. 0 invalidates immediately. Default: 86400 (24h).

Response

Secret rotated