Rotate Partner Webhook
Rotate the signing key of a partner webhook (overlap rotation).
Mints a fresh secret (returned exactly once) and keeps the previous key(s) valid for
grace_seconds so the partner can switch over without dropping deliveries.
Authorizations
Get token from Auth0 and paste it here
Path Parameters
Category of partner webhook.
payroll_status Body
Body accepted on the rotate (POST) request.
Only the grace window is accepted; the current secret is NOT required — the endpoint
is gated by the write:partner_webhooks scope. The outgoing key(s) stay valid for
grace_seconds so the partner can switch over without dropping deliveries.
How long the previous key(s) stay valid after rotation
0 <= x <= 604800Response
Successful Response
Response for setup (first PUT) and rotate: the generated secret is shown once.
secret is null on a repeat PUT that only updates url/enabled without minting a
new key.
Auth0 client_id of the partner
Event category, e.g. payroll_status
payroll_status Whether deliveries are sent for this webhook
HTTPS endpoint we POST events to
1 - 2083Signing secret — shown once, store it now