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

# List webhooks

`GET /v1/webhooks/endpoints`

List configured webhook endpoints for your account. Cursor-paginated; see the [Pagination](/pagination) guide.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Configured endpoints

- WebhookEndpointListResponse
  - `endpoints` WebhookEndpoint[], required
    - `endpointId` string, required — Webhook endpoint id (e.g. `ep_...`).
    - `url` string, uri, required
    - `events` WebhookEventName[], required
    - `description` string, nullable
    - `createdAt` integer, required — Seconds since epoch (Unix timestamp) when the endpoint was created.
    - `signingSecret` string — HMAC secret for verifying [Standard Webhooks](https://www.standardwebhooks.com/) signatures. Only returned once on create; store it securely.
    - `signingSecretLast4` string — Last four characters of the signing secret, for display purposes.
  - `hasMore` boolean, required — When true, there are more endpoints available. Pass `nextCursor` as the `cursor` query param to fetch the next page.
  - `nextCursor` string, nullable, required — Opaque cursor to fetch the next page. `null` when `hasMore` is false.

## Other responses

- `default` — Error

---

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