Register a webhook endpoint
Webhooks
Register a webhook endpoint
The signing secret is returned exactly once, here. Store it — nothing can recover it.
Requires the webhooks.write scope.
A subject-bound key cannot manage webhook endpoints. One endpoint receives the transitions of every checkout the tenant runs, for every end user, so registering or reading them from a single person’s key would be a way to subscribe to everyone else’s activity. 403.
POST
Register a webhook endpoint
Authorizations
Authorization: Bearer ck_test_… or ck_live_…. There is no other auth scheme — no query-string keys, no request signing, no OAuth.
Body
application/json