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

# List webhook subscriptions

`GET /v1/workspaces/{workspace_id}/webhooks`

## Request

- Base URL: `https://api.blinq.me`
- URL: `https://api.blinq.me/v1/workspaces/{workspace_id}/webhooks`
- Auth: HTTP bearer

Available to any API-eligible account with a verified email address.

Returns the active webhook subscriptions stored for your personal workspace or a business workspace where you are an owner or admin, ordered by creation time and then ID, oldest first, in one response without pagination.

Business members and other workspaces return `404`. Deleted subscriptions are excluded.

Requires the `blinq:webhooks:read` scope.

## Path parameters

- `workspace_id` string, required

## Response `200`

The active webhook subscriptions in the workspace.

- object: The active webhook subscriptions in the workspace.
  - `webhooks` object[], required: Active subscriptions, ordered by creation time then ID, oldest first. Empty when the workspace has none.
    - `id` string, required: The subscription ID.
    - `url` string, required: The normalized HTTPS destination URL for deliveries.
    - `events` string[], required: The stored event-name filters for the subscription.
    - `created_at` string, required: When the subscription was created, in ISO 8601 format.

## Other responses

- `400`: Bad request - Invalid query parameters or body. See `details` for each failing field
- `401`: Unauthorized - Missing or invalid API key
- `403`: Forbidden - Missing scope, insufficient permission, or the plan does not include this operation
- `404`: Not found - The workspace was not found, you are not its owner or admin, or access was denied

---

[API](https://skmtc.dev/blinq/apis/blinq-public-api.md) - [All operations](https://skmtc.dev/blinq/apis/blinq-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blinq/apis/blinq-public-api/revisions/2dedf4b14340?raw)