Webhooksv2

Create a webhook (closed)

POST/webhooks

Registration through this endpoint is closed and returns 410. Use POST /v4/webhooks to create new subscriptions. Existing webhooks keep working and can still be listed, updated, and deleted here. Re-posting the URL of a webhook that already exists still returns 200 with that webhook, so idempotent provisioning scripts continue to work unchanged.

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_urlRequiredstring

URL of an existing webhook, for the idempotent 200 response. A URL that does not already exist returns 410.

valid_untiloptionalinteger

Ignored. Retained so existing request bodies stay valid.

Returns

webhook_idoptionalstring

webhook_urloptionalstring

scopeoptionalstring

"api_key""organization"

messageoptionalstring

Response codes

200Webhook already exists (idempotent)

400Invalid request parameters

401Authentication required or invalid

409Webhook limit reached (max 64 per organization)

410Registration through this endpoint is closed. Use POST /v4/webhooks.

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

Request

curl -X POST https://api.blooio.com/v2/api/webhooks \

  -H "Authorization: Bearer bl_live_..." \  -H "Content-Type: application/json" \  -d '{    "webhook_url": "https://example.com/webhook",    "valid_until": -1  }'

Body object

{  "webhook_url": "https://example.com/webhook",  "valid_until": -1}

Response objectexample

{  "webhook_id": "wh_a1b2c3d4",  "webhook_url": "https://example.com",  "scope": "api_key",  "message": "Hello from Blooio!"}