Update Webhook

Update a webhook’s URL, events, room scope, or enabled state. At least one field must be provided.

Endpoint

PATCH /v1/accounts/:accountId/webhooks/:id

Authentication

Bearer token required.

Path Parameters

string

required

The webhook’s unique ID.

Request Body

All fields are optional, but at least one must be provided.

string

New delivery URL.

string[]

New list of subscribed events.

string | null

New room scope. Set to null to subscribe to events from all rooms.

boolean

Enable or disable the webhook.

Response

WebhookRegistrationPublic

The updated webhook object (without the secret field). See WebhookRegistrationPublic.

Example

curl -X PATCH https://api.collab-kit.com/v1/accounts/${ACCOUNT_ID}/webhooks/wh_abc123 \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "events": ["participant.joined", "participant.left", "user.created"],
    "enabled": true
  }'

const res = await fetch(`https://api.collab-kit.com/v1/accounts/${accountId}/webhooks/wh_abc123`, {
  method: 'PATCH',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    events: ['participant.joined', 'participant.left', 'user.created'],
    enabled: true,
  }),
});
const { data } = await res.json();

Response

{
  "type": "response",
  "success": true,
  "description": "Webhook updated",
  "data": {
    "webhook": {
      "id": "wh_abc123",
      "organization_id": "a1b2c3d4-...",
      "url": "https://api.example.com/collab-webhook",
      "events": ["participant.joined", "participant.left", "user.created"],
      "room_id": null,
      "enabled": true,
      "created_at": "2026-05-29T10:00:00.000Z",
      "updated_at": "2026-05-29T11:00:00.000Z"
    }
  },
  "error": null
}

Overview

Rooms

Users

Storage

Webhooks

Workflows

Endpoint

Authentication

Path Parameters

Request Body

Response

Example

​Endpoint

​Authentication

​Path Parameters

​Request Body

​Response

​Example

Endpoint

Authentication

Path Parameters

Request Body

Response

Example