v20

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-011984401.2 MB

Webhooks

Rotate a webhook signing secret

Rotates the endpoint's signing secret. The previous secret keeps signing for a 24h grace window so consumers can update without missing deliveries. Returns the new secret ONCE. Requires the webhooks.manage permission; league-scoped endpoints additionally require current league ADMIN membership and the webhooks feature on the league owner's plan.

post/webhooks/{id}/rotate-secret

Path parameters

idstring required

Webhook endpoint id.

Response

The new one-time signing secret.

idstring required

The endpoint id the secret belongs to.

signingSecretstring required

Plaintext signing secret. Shown ONCE - store it now.

secretPrefixstring required

First 8 chars of the new signing secret.