---
title: "List webhooks"
method: GET
path: "/v2/webhooks"
tags: ["Webhooks"]
---

# List webhooks

`GET /v2/webhooks`

Returns a page of webhooks in the current workspace. By default, the first 20 matching webhooks are ordered by creation time, newest first. Supplied filters are combined, `count` reports the total number of matches before pagination, and `has_more` indicates whether another page is available.

## Query parameters

- `page` integer
- `limit` integer
- `search` string
- `event` string
- `sort` string
- `direction` string
- `content_type` string
- `enabled` boolean

## Response `200`

OK

- ListWebhooksResponse — A page of webhooks and the total number of matching records.
  - `count` integer, required — Total number of webhooks matching the filters, before pagination.
  - `items` Webhook[], required — Requested page of webhooks.
    - `_id` string, required — Unique webhook ID.
    - `url` string, uri, required — HTTPS endpoint that receives webhook deliveries.
    - `content_type` 'application/json' | 'application/x-www-form-urlencoded', required — Content type sent with webhook deliveries.
    - `display_name` string, required — Human-readable webhook name.
    - `events` string[], required — Workspace event slugs that trigger a delivery, for example `deployment.invoked` or `llm.response`.
    - `secret` string, required — Signing secret used to compute `X-Orq-Signature` as the lowercase hexadecimal HMAC-SHA256 of the exact request body bytes. Treat this value as sensitive.
    - `enabled` boolean — Whether webhook deliveries are enabled.
    - `failure_count` integer — Server-managed number of consecutive delivery failures.
    - `created_by_id` string, required — Account ID that created the webhook.
    - `updated_by_id` string, required — Account ID that most recently updated the webhook.
    - `created` string, date-time, required — Creation time in RFC 3339 format.
    - `updated` string, date-time, required — Most recent update time in RFC 3339 format.
  - `has_more` boolean, required — Whether another page of matching webhooks is available.

---

[API](https://skmtc.net/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.net/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/versions/6a22c53a2580/schema)