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

# List webhook subscriptions

`GET /v1/webhooks`

## Request

- Base URL: `https://app.getdealboard.com`
- URL: `https://app.getdealboard.com/v1/webhooks`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `cursor` string
- `boardId` string, uuid

## Response `200`

OK

- WebhookList
  - `data` Webhook[], required
    - `id` string, uuid, required
    - `boardId` string, uuid, required
    - `label` string, nullable, required
    - `urlFingerprint` string, required: Last 4 characters of the URL. The URL itself is a secret and is never returned.
    - `provider` 'slack' | 'teams' | 'discord' | 'generic', required
    - `events` string[], required
    - `stageFilter` string[], required: Stage IDs (per-board) to filter `deal.stage_changed` events to. Empty = all stages.
    - `active` boolean, required
    - `createdAt` string, date-time, required
    - `lastDeliveredAt` string, date-time, nullable, required
    - `lastError` string, nullable, required
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required: Pass as `?cursor=` on the next request to fetch the next page.

---

[API](https://skmtc.dev/getdealboard/apis/dealboard-api.md) · [All operations](https://skmtc.dev/getdealboard/apis/dealboard-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getdealboard/apis/dealboard-api/revisions/4066bf9d265e?raw)