---
title: "Get webhook subscription"
method: GET
path: "/api/v3.1/webhook_subscriptions/{id}"
tags: ["Webhook Subscriptions"]
---

# Get webhook subscription

`GET /api/v3.1/webhook_subscriptions/{id}`

Retrieves a webhook subscription by ID.

## Path parameters

- `id` string, webhookSubscriptionId, required — Webhook subscription ID

## Response `200`

Webhook subscription retrieved

- object
  - `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

## Other responses

- `401` — Unauthorized
- `404` — Subscription not found
- `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)