Skip to main content
POST
Register a webhook endpoint

Authorizations

Authorization
string
header
required

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
url
string<uri>
required

Must be https://. http://localhost and http://127.0.0.1 are allowed for development.

label
string
Maximum string length: 200

Response

Registered.

id
string<uuid>
required
url
string<uri>
required
label
string | null
required
secret
string
required

whsec_…. Shown once. Used to verify the t=…,v1=… signature header.