---
title: "List Webhook Logs"
method: GET
path: "/api/v1/webhooks/logs"
tags: ["Webhooks"]
---

# List Webhook Logs

`GET /api/v1/webhooks/logs`

List webhook delivery attempts for the caller's organization. Filter by `webhook_id` (see `GET /webhooks` for available ids) or `connector_id` to narrow the results.

## Query parameters

- `page_size` integer — Number of results to return per page.
- `cursor` string — The pagination cursor value.
- `webhook_id` string, uuid, nullable — Restrict results to deliveries for this webhook.
- `connector_id` string, uuid, nullable — Restrict results to deliveries triggered for this connector.
- `webhook_action` string, nullable — Comma-separated webhook event types to filter logs by.
- `response_code` string — Comma-separated HTTP response codes to filter logs by.
- `created_at_from` string — Only logs created at or after this datetime. Format: ISO 8601.
- `created_at_to` string — Only logs created at or before this datetime. Format: ISO 8601.
- `errors_only` boolean — If true, only error logs (HTTP response code >= 400) are returned.

## Response `200`

Successful Response

- PaginatedResponseWebhookLogEntryExternal
  - `cursor` string, nullable, required — Cursor value to fetch next set of items
  - `page_size` integer, required — Indicates the count of items in the response
  - `items` WebhookLogEntryExternal[], required — List of items in the current response
    - `id` string, uuid, required — Unique identifier of the delivery attempt.
    - `connector_id` string, uuid, required — Connector this delivery was triggered for.
    - `method` 'GET' | 'POST' | 'PUT' | 'DELETE'
    - `url` string, required — URL the webhook was delivered to.
    - `response_code` integer, nullable — HTTP status code returned by the receiving endpoint.
    - `created_at` string, date-time, nullable
    - `integration_name` string, nullable — Integration of the connector that triggered this delivery.
    - `end_user_name` string, nullable — End user of the connector that triggered this delivery.
    - `origin_id` string, nullable — Origin ID of the end user associated with the connector.
    - `webhook_action` 'connector_synced' | 'connector_sync_started' | 'connector_data_modified' | 'employee_data_changed' | 'connector_sync_error'
    - `webhook_name` string, nullable — Name of the webhook.

## Other responses

- `401` — Missing or invalid bearer authentication credentials.
- `403` — The credentials are valid but do not permit access to this resource, e.g. a connector token used on a different API category or a model whose writes are disabled.
- `422` — Validation Error
- `429` — Rate limit exceeded.

---

[API](https://skmtc.net/bindbee/apis/bindbee-apis.md) · [All operations](https://skmtc.net/bindbee/apis/bindbee-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bindbee/bindbee-apis/versions/7da10dc93a21/schema)