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.

url

string

New delivery URL.

events

string[]

New list of subscribed events.

roomId

string | null

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

enabled

boolean

Enable or disable the webhook.

Response

webhook

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