Rotate webhook signing secret
POST
/v1/webhooks/{webhook_id}/rotate-secret
Generates a new signing secret for the endpoint. During a 24-hour overlap window, both the old and new secrets sign every delivery so consumers can migrate without dropped events. Store the new secret immediately — it is not retrievable after this response.
Response Payload
secret
string
required
The new signing secret (whsec_ prefix). Store this immediately — it is not shown again.
cURL
curl -X POST "https://us1.platform.bird.com/v1/webhooks/{webhook_id}/rotate-secret" \
-H "Authorization: Bearer $TOKEN"