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

# List webhooks

`GET /webhooks`

## Request

- Base URL: `https://api.mockflow.com/v1`
- URL: `https://api.mockflow.com/v1/webhooks`
- Auth: HTTP bearer

Every webhook in the workspace. The signing secret is not included; it is shown when a webhook is created or its secret rotated.

## Response `200`

OK

- object
  - `data` Webhook[]
    - `id` string
    - `url` string, uri
    - `events` string[]
    - `boardId` string, nullable: Null for every board in the workspace.
    - `description` string
    - `active` boolean
    - `pausedReason` string, nullable: Why MockFlow paused it
    - `createdBy` string, nullable: Events are sent only about boards this person can open.
    - `createdAt` string, date-time
    - `updatedAt` string, date-time, nullable

## Other responses

- `429`: Too many requests.
- `4XX`: An error. See the envelope and the code list on the Errors page.

---

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