---
title: "List Webhook Endpoints"
method: POST
path: "/webhook-endpoints/list"
---

# List Webhook Endpoints

`POST /webhook-endpoints/list`

## Request

- Base URL: `https://api.dashboard.knotapi.com`
- URL: `https://api.dashboard.knotapi.com/webhook-endpoints/list`
- Auth: HTTP bearer

List webhook endpoints in an environment.

## Request body

- object
  - `environment` 'development' | 'production', required: The environment the webhook endpoint belongs to. Must match your access token's environment.

## Response `200`

Successful request.

- object
  - `webhook_endpoints` WebhookEndpoint[]: Webhook endpoints, newest first.
    - `id` string: Unique identifier for the webhook endpoint.
    - `url` string: The URL Knot sends webhooks to.
    - `description` string, nullable: A description of the webhook endpoint, or `null` if none.
    - `environment` 'development' | 'production': The environment the webhook endpoint belongs to.
    - `created_at` string, date-time: When the webhook endpoint was created, in ISO 8601 format.

## Other responses

- `400`: Bad request.
- `401`: Unauthorized request.
- `403`: Forbidden request.
- `429`: Too many requests.
- `500`: Internal server error.

## Changes

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

[Operation history](https://skmtc.dev/knotapi/apis/knot-api/changes/webhook-endpoints/list/post.md)

---

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