Skip to main content
GET
List Webhook Logs
Each entry records one delivery attempt: which webhook fired, for which connector, and the response_code your endpoint returned. Polling this with errors_only=true on a schedule is the practical way to catch a silently broken endpoint — nothing else tells you deliveries have stopped succeeding. See Monitoring deliveries.
This endpoint defaults to page_size=25 with a maximum of 50 — see Pagination.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

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 types to filter logs by.

Example:

"connector_synced,employee_data_changed"

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

Indicates the count of items in the response

Example:

50

items
WebhookLogEntryExternal · object[]
required

List of items in the current response