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

# List Webhooks

`GET /v1/webhooks`

List all webhooks for the authenticated user. Requires API key with webhook:read.

## Response `200`

Webhooks list

- ApiResponseWebhooksList
  - `success` boolean, required
  - `data` object, nullable
    - `webhooks` Webhook[]
      - `id` string — Webhook ID
      - `url` string, uri — The webhook endpoint URL
      - `events` string[] — Subscribed event types
      - `active` boolean — Whether the webhook is active
      - `secretConfigured` boolean — Whether a signing secret is configured. The secret value itself is returned only once, in the create response.
      - `description` string — Optional description
      - `successCount` integer — Number of successful deliveries
      - `failureCount` integer — Number of failed deliveries
      - `lastTriggeredAt` string, date-time — Last trigger timestamp
      - `createdAt` string, date-time — Creation timestamp
      - `updatedAt` string, date-time — Last update timestamp
    - `total` integer
  - `error` string, nullable

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/migma/apis/migma-ai-api-v1.md) · [All operations](https://skmtc.net/migma/apis/migma-ai-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/migma/migma-ai-api-v1/revisions/3f3dba69574b/schema)