Create webhook subscription
POST/openapi/v1/webhooks
Create a new subscription. Server generates a synthetic whk_<16chars> ID and a fresh signing secret. The plaintext secret is returned ONCE in the response (under attributes.delivery.signingSecret); subsequent reads only return signingSecretLastFour. Save the returned secret — there is no API to recover it. Use /rotate to replace it.
Request
Responses
- 200
- 401
- 403
- 429
- 500
OK
Authentication required
Caller is not authorised
Rate limit exceeded — see Retry-After header
Internal server error