Register a new webhook endpoint for the merchant business. Returns the generated signing secret — shown only once and must be stored securely.
POST /v1/webhooks/endpoints
POST
/v1/webhooks/endpoints
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Header Parameters
Section titled “Header Parameters ” Idempotency-Key
string
Required on every mutating /v1/* endpoint (Phase 1 fixture relaxes to optional)
Request Body required
Section titled “Request Body required ”object
url
required
string format: uri
secret
string
enabled_events
Array<string>
active
boolean
metadata
object
key
additional properties
Responses
Section titled “ Responses ”object
success
required
boolean
data
required
object
id
required
string
url
required
string
secret
required
string
enabled_events
required
active
required
boolean
metadata
required
meta
required
object
requestId
required
string