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

# Update webhook subscription

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

Updates a webhook subscription. At least one field must be provided.

## Path parameters

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

## Request body

- object
  - `webhook_url` string, uri — HTTPS URL to receive webhook events
  - `enabled_events` string[] — Array of event types to subscribe to
  - `version` 'V1' | 'V2' | 'V3' — Webhook payload version

## Response `200`

Webhook subscription updated

- 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

- `400` — Invalid request
- `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)