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
Authorizations
API key starting with sk_case_
Path Parameters
Body
application/json
How long (seconds) the old secret continues to be accepted. 0 invalidates immediately. Default: 86400 (24h).
Required range:
0 <= x <= 2592000Response
Secret rotated
Previous
Send a test event to a webhook endpointSynchronously delivers a synthetic `webhook.test` event to the endpoint and returns the HTTP result. No retries. Useful for validating that a new endpoint is reachable and its signature verifier works. The delivery is not persisted in the delivery history.
Next