Skip to main content
POST
/
webhooks
/
{webhook_id}
/
rotate-secret
Rotate webhook secret
curl --request POST \
  --url https://api.struct.to/v1/webhooks/{webhook_id}/rotate-secret
{
  "secret": "<string>",
  "rotated_at": 123
}

Path Parameters

webhook_id
string
required

Webhook UUID

Response

New secret generated

Response for POST /v1/webhook/{id}/rotate-secret

secret
string
required

The new HMAC secret (only returned once — store it securely)

rotated_at
integer<int64>
required

Timestamp of rotation (ms since epoch)

Last modified on March 17, 2026