---
title: "List webhook endpoints"
method: GET
path: "/v4/webhook_endpoints"
tags: ["Webhooks"]
---

# List webhook endpoints

`GET /v4/webhook_endpoints`

## Request

- Base URL: `https://api.kit.com`
- URL: `https://api.kit.com/v4/webhook_endpoints`
- Auth: one of:
  - API key in header `X-Kit-Api-Key`
  - OAuth 2
    - Authorization code: `https://api.kit.com/v4/oauth/authorize`
    - Token URL: `https://api.kit.com/v4/oauth/token`

Returns a paginated list of the account's webhook endpoints. Filter with `status` to return only `active` or `disabled` endpoints.

<strong>OAuth app scoping:</strong> When authenticating with OAuth, this endpoint returns only webhooks created by your OAuth application. Webhooks created via the Kit UI, API keys, or other OAuth apps are not visible. To access all webhooks on an account, authenticate with an API key instead.

Webhook endpoints are the current generation of Kit webhooks: one endpoint subscribes to many [event types](/webhooks/event-types) and receives signed, automatically retried deliveries. They supersede the [legacy Webhooks](/api-reference/webhooks-legacy/list-webhooks) resource — which keeps working — and are the right choice for all new integrations. Start with the [webhooks guides](/webhooks/overview).

## Query parameters

- `after` unknown
- `before` unknown
- `include_total_count` boolean
- `per_page` unknown
- `status` 'active' | 'disabled'

## Response `200`

Returns a paginated list of webhook endpoints

- object
  - `webhook_endpoints` object[], required
    - `id` integer, required
    - `name` string, required
    - `url` string, required
    - `events` string[], required
    - `status` string, required
    - `source` string, required
    - `description` string, required
    - `created_by_app` unknown, required
    - `created_at` string, required
    - `previous_secret_expires_at` unknown, required
  - `pagination` object, required
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `start_cursor` string, required
    - `end_cursor` string, required
    - `per_page` integer, required

## Changes

- **2026-11-03** `f04308f83b63`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kit/apis/kit-api/changes/v4/webhook_endpoints/get.md)

---

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