Create webhook subscription
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Headers
Optional client-generated idempotency token (recommended for safe retries).
Unix seconds. Required on the signed host; tolerance is 300s either way (403 request_timestamp_skew).
Lowercase hex SHA-256 of the body. An empty body hashes the empty string, so the header is always present. Mismatch returns 400 body_hash_mismatch.
Detached JWS (<protected>..<signature>, ES256 or PS256) over METHOD\nPATH?QUERY\nTIMESTAMP\nIDEMPOTENCY_KEY_OR_EMPTY\nX_CONTENT_SHA256.
Request
Authentication applied to webhook delivery. HMAC signs each request with secret in the X-Signature header; NONE uses the platform default signature. Any other value is rejected.
Secret used for HMAC signing. Required when authType is HMAC.
Binds the subscription to a single account: it then receives only that account’s events. Omit for a tenant-wide subscription (every account, the historical behaviour). Not editable afterwards. A credential restricted to specific accounts MUST provide it (422 account_id_required) and may only point at accounts it reaches (403 forbidden).
Response
Account this subscription is bound to. null means tenant-wide: it receives every account’s events.