---
title: "List Webhook Endpoints"
method: GET
path: "/v2/webhooks/endpoints"
tags: ["webhooks"]
---

# List Webhook Endpoints

`GET /v2/webhooks/endpoints`

List the organization's webhook endpoints, with their filters, whether each is disabled and why, and the most recent delivery. Secrets are never included.

## Response `200`

Successful Response

- WebhookEndpointList
  - `endpoints` WebhookEndpoint[], required
    - `endpoint_id` string, required — The endpoint's id (`whe_...`).
    - `url` string, required — HTTPS URL that receives events.
    - `description` string, required — Free-text label. Empty string when not set.
    - `event_types` string[], required — Events this endpoint receives. Empty means all five.
    - `collection_ids` string[], required — Collection filter. Empty means every collection.
    - `sync_ids` string[], required — Sync filter. Empty means no sync filter.
    - `sources` string[], required — Source filter (`api`, `sync`). Empty means both.
    - `channels` string[], required — Filters set in Captain Studio's Webhooks page that cannot be expressed as `collection_ids`, `sync_ids` and `sources`. Empty for endpoints whose filters were set through the API. Setting `collection_ids`, `sync_ids` or `sources` with `PATCH` replaces them.
    - `include_collection_name` boolean, required — Whether payloads sent to this endpoint may carry `collection_name`.
    - `disabled` boolean, required — `true` when no events are being sent to this endpoint.
    - `disabled_reason` string, nullable, required — `delivery_failures` when Captain disabled the endpoint after sustained failed deliveries. `null` when it is enabled or was paused through the API.
    - `last_delivery` WebhookLastDelivery, required
      - `at` string, date-time, required — When the most recent delivery attempt finished.
      - `status` 'succeeded' | 'failed', required — Outcome of that delivery.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `limit` integer, required — The most endpoints the organization may have (20).

## Other responses

- `401` — Missing or invalid API key.
- `429` — `Too many webhook management requests. Try again shortly.` Retry after the `Retry-After` header.

## Changes

- **2026-09-24** `61a9364ad042` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/runcaptain/apis/api-reference/changes/v2/webhooks/endpoints/get.md)

---

[API](https://skmtc.dev/runcaptain/apis/api-reference.md) · [All operations](https://skmtc.dev/runcaptain/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/runcaptain/apis/api-reference/revisions/ac61e472bb7d?raw)