---
title: "Get Webhook Endpoint"
method: GET
path: "/v2/webhooks/endpoints/{endpoint_id}"
tags: ["webhooks"]
---

# Get Webhook Endpoint

`GET /v2/webhooks/endpoints/{endpoint_id}`

Get one webhook endpoint: its URL, filters, whether it is disabled and why, and the most recent delivery. The secret is never included.

`disabled_reason` is `delivery_failures` when Captain disabled the endpoint after sustained failed deliveries. Re-enable it with `PATCH` and `{"disabled": false}`, then recover the events it missed.

## Path parameters

- `endpoint_id` string, required

## Response `200`

Successful Response

- WebhookEndpoint — A webhook endpoint. Never includes the signing secret.
  - `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

## Other responses

- `401` — Missing or invalid API key.
- `404` — `Webhook endpoint not found.` The id does not exist, or belongs to another organization.
- `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/:endpoint_id/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)
