Skip to main content
GET
List Webhook Logs
Each entry records one event sent to one webhook: which webhook fired, for which connector, and the response_code of the final attempt. Retries are not logged separately, and 518 means your endpoint gave no response. Poll this with errors_only=true on a schedule to catch an endpoint that has stopped accepting deliveries. Nothing else tells you. See Monitor deliveries.
This endpoint defaults to page_size=25 with a maximum of 50 - see Pagination.

Authorizations

Authorization
string
header
default:<BINDBEE_API_KEY>
required

Your Bindbee API key, sent as Authorization: Bearer <BINDBEE_API_KEY>. Required on every request.

Query Parameters

page_size
integer
default:25

Number of results to return per page.

Required range: 1 <= x <= 50
cursor
string | null

The pagination cursor value.

webhook_id
string<uuid> | null

Restrict results to deliveries for this webhook.

connector_id
string<uuid> | null

Restrict results to deliveries triggered for this connector.

webhook_action
string | null

Comma-separated webhook event names to filter logs by.

Example:

"connector_synced,hris.employee.created"

response_code
string | null

Comma-separated HTTP response codes to filter logs by.

Example:

"200,403,503"

created_at_from
string | null

Only logs created at or after this datetime. Format: ISO 8601. If no timezone offset is supplied, the value is interpreted as UTC.

Example:

"2024-02-21T21:22:12.993Z"

created_at_to
string | null

Only logs created at or before this datetime. Format: ISO 8601. If no timezone offset is supplied, the value is interpreted as UTC.

Example:

"2024-02-21T21:22:12.993Z"

errors_only
boolean
default:false

If true, only error logs (HTTP response code >= 400) are returned.

Response

Successful Response

cursor
string | null
required

Cursor value to fetch next set of items

Example:

"MDE4YjE4ZWYtYzk5Yy03YTg2LTk5NDYtN2I3YzlkNTQzM2U1"

page_size
integer
required

The page size the request was served with (0 on an empty page). items can be shorter on the last page; cursor says whether another page exists.

Example:

50

items
WebhookLogEntryExternal · object[]
required

List of items in the current response