---
title: "List webhook subscriptions"
method: GET
path: "/api/v3.1/webhook_subscriptions"
tags: ["Webhook Subscriptions"]
---

# List webhook subscriptions

`GET /api/v3.1/webhook_subscriptions`

Lists all webhook subscriptions for the authenticated project with pagination. Currently limited to one subscription per project.

## Query parameters

- `limit` number, nullable
- `cursor` string

## Response `200`

Webhook subscriptions retrieved

- object
  - `items` object[], required
    - `id` string, webhookSubscriptionId, required — Unique subscription ID
    - `webhook_url` string, required — Webhook destination URL
    - `version` 'V1' | 'V2' | 'V3', required — Webhook payload version
    - `enabled_events` string[], required — Subscribed event types
    - `secret` string, required — Signing secret for HMAC verification
    - `created_at` string, required — ISO 8601 timestamp
    - `updated_at` string, required — ISO 8601 timestamp
  - `next_cursor` string, nullable
  - `total_pages` number, required
  - `current_page` number, required
  - `total_items` number, required

## Other responses

- `400` — Invalid pagination
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/versions/4239836857f8/schema)