API Referencewebhooks

List webhook deliveries

View as Markdown
List delivery attempts for one webhook endpoint, including response status and retry state.

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.

Query parameters

cursorstringOptional
limitintegerOptional<=200Defaults to 50

Response

OK
datalist of objects
nextCursorstring or null

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error