API Referencewebhooks

Get a webhook

View as Markdown
Get one webhook endpoint without exposing its signing secret.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

webhookIdstringRequired
Unique webhook identifier generated by BCTRL.

Headers

BCTRL-Subaccount-IdstringOptional
Optional effective subaccount context for organization API keys. Subaccount API keys are already scoped and cannot use this header to act as another subaccount.

Response

OK
createdAtdatetime
RFC 3339 timestamp with a UTC offset.
enabledboolean
eventslist of enums
idstring
Unique webhook identifier generated by BCTRL.
namestring or null1-80 characters
subaccountIdstring or null
updatedAtdatetime
RFC 3339 timestamp with a UTC offset.
urlstringformat: "uri"<=2048 characters

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error