Rotate webhook secret

curl --request POST \
  --url https://api.struct.to/v1/webhooks/{webhook_id}/rotate-secret

{
  "secret": "<string>",
  "rotated_at": 123
}

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
}

webhook_id

string

required

Webhook UUID

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 June 16, 2026