---
title: "List webhook endpoints"
method: GET
path: "/v1/webhooks/endpoints"
tags: ["Webhooks"]
---

# List webhook endpoints

`GET /v1/webhooks/endpoints`

Lists the webhook subscriptions owned by the authenticated API key's user. Endpoints are scoped per user rather than shared across the workspace. Events are routed to the user context that emits them; playlist.video_added is delivered to the user who adds the video, who may be a playlist editor rather than its owner.

## Query parameters

- `cursor` string — Pagination cursor returned by the previous request
- `limit` integer — Maximum endpoints to return (default: 20, max: 100)

## Response `200`

A page of webhook endpoints

- ListWebhookEndpointsResponse — A page of webhook subscription endpoints
  - `endpoints` WebhookEndpoint[], required
    - `createdAt` string, date-time, required — When the endpoint was created
    - `disabled` boolean, required — Whether delivery to this endpoint is disabled
    - `filterTypes` string[], nullable, required — Event types delivered to this endpoint, or null when no filter is set and every event type is delivered
    - `id` string, required — Unique identifier for the webhook endpoint
    - `updatedAt` string, date-time, required — When the endpoint was last updated
    - `url` string, uri, required — The URL where webhook events are sent
  - `nextCursor` string, nullable, required — Cursor for the next page, or null on the final page

## Other responses

- `400` — The request was malformed or contained invalid parameters.
- `401` — Authentication is required. Provide a valid API key.
- `403` — You don't have permission to access this resource.
- `404` — The requested resource was not found.
- `429` — You have exceeded the rate limit. Please slow down.
- `500` — An unexpected error occurred
- `501` — The requested operation is not implemented.

---

[API](https://skmtc.dev/withchima/apis/tella-public-api.md) · [All operations](https://skmtc.dev/withchima/apis/tella-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withchima/tella-public-api/revisions/ba2bb13928a5/schema)