Webhooks

Rotate webhook endpoint signing secret

Generates a new signing secret for the endpoint. The previous secret stays valid for 24 hours so receivers can roll over without dropping deliveries.

post/v1/webhooks/endpoints/{endpointId}/secret/rotate

Path parameters

endpointIdstring required
Example:ep_1234567890abcdef

The ID of the webhook endpoint

Headers

X-API-Keystring

API key

Response

Signing secret rotated successfully

keystring required

Signing secret used to verify webhook signatures on this endpoint

Example response

{
  "key": "whsec_C2FVsBQIhrscChlQIMVub5sSYspob7oD"
}

Changes

No recorded changes to this endpoint across all 5 revisions of this API.