Webhooksv2

Update a webhook

PATCH/webhooks/{webhookId}

Update a webhook's configuration.

Path parameters

webhookIdRequiredstring

Unique identifier of the webhook subscription, prefixed with wh_ (e.g. wh_abc123def456). Returned when you create or list webhooks.

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

webhook_typeoptionalstring

Type of events to receive

"message""status""all"

valid_untiloptionalinteger

Expiration timestamp. Use -1 or null for no expiration.

deprecateoptionalboolean

Set to true to deprecate, false to undeprecate

Returns

webhook_idoptionalstring

webhook_urloptionalstring

webhook_typeoptionalstring

"message""status""all"

scopeoptionalstring

"api_key""organization""integration"

api_key_nameoptionalstring | null

Name of the API key (if scope is api_key)

integration_nameoptionalstring | null

Name of the integration (if scope is integration)

created_atoptionalinteger

deprecated_atoptionalinteger | null

valid_untiloptionalinteger

-1 means no expiration

last_triggeredoptionalinteger | null

failure_countoptionalinteger

is_activeoptionalboolean

Whether the webhook is active (not deprecated)

Response codes

200Webhook updated

400Invalid request parameters

401Authentication required or invalid

404Resource not found

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/v2/api/webhooks/wh_abc123def456 \  -H "Authorization: Bearer bl_live_..." \  -H "Content-Type: application/json" \  -d '{    "webhook_type": "message",    "valid_until": 0,    "deprecate": false  }'

Body object

{  "webhook_type": "message",  "valid_until": 0,  "deprecate": false}

Response objectexample

{  "webhook_id": "wh_a1b2c3d4",  "webhook_url": "https://example.com",  "webhook_type": "message",  "scope": "api_key",  "api_key_name": "sk_live_a1b2c3d4",  "integration_name": "string",  "created_at": 0,  "deprecated_at": 0,  "valid_until": 0,  "last_triggered": 0,  "failure_count": 3,  "is_active": true}