Webhooksv4

Update a webhook

PATCH/webhooks/{webhookId}

Updates url, event_types, or status (active/disabled).

Path parameters

webhookIdRequiredstring

Unique identifier of the webhook subscription, prefixed with wh_. Returned when you create a webhook or by the List webhooks endpoint.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Body parameters

JSON
urloptionalstring
event_typesoptionalstring[]

Retired. Omit this field to leave an existing subscription's frozen list untouched; sending anything narrower than ["*"] is rejected with 422 event_types_retired.

statusoptionalstring
"active""disabled"

Returns

dataoptionalWebhook
idoptionalstring

Webhook id (wh_...).

urloptionalstring
event_typesoptionalstring[]

The events this webhook receives. ["*"] for every webhook created since event filtering was retired; subscriptions registered before that keep their original list, which is frozen and cannot be changed.

statusoptionalstring
"active""disabled"
scopeoptionalstring

Which lines this subscription receives events for. organization covers every line; the other two are limited to the lines that owner holds.

"organization""api_key""integration"
api_keyoptionalstring | null

The owning API key when scope is api_key, otherwise null.

integration_idoptionalstring | null

The owning integration when scope is integration, otherwise null.

channel_idoptionalstring | null
channel_typeoptionalstring | null
created_atoptionalinteger

Response codes

200Updated webhook
401Your API key is missing or invalid. Pass it as a bearer token.
404No webhook was found with the provided `webhookId`.
422Validation failed — one or more fields in the request are invalid or missing.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request
curl -X PATCH https://api.blooio.com/v4/webhooks/wh_a1b2c3d4 \
Body object
Response objectexample
{  "data": {    "id": "wh_a1b2c3d4",    "url": "https://example.com",    "event_types": [      "string"    ],    "status": "active",    "scope": "organization",    "api_key": "sk_live_a1b2c3d4",    "integration_id": "wh_a1b2c3d4",    "channel_id": "ch_a1b2c3d4",    "channel_type": "string",    "created_at": 0  }}