Webhooksv2

Create a webhook

POST/webhooks

Create a new webhook subscription.

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 to receive webhook events

webhook_typeoptionalstring

Type of events to receive

"message""status""all"

valid_untiloptionalinteger

Expiration timestamp (-1 for no expiration)

Returns

webhook_idoptionalstring

webhook_urloptionalstring

scopeoptionalstring

"api_key""organization"

messageoptionalstring

Response codes

200Webhook already exists (idempotent)

201Webhook created. The signing_secret is shown only once - store it securely.

400Invalid request parameters

401Authentication required or invalid

409Webhook limit reached (max 64 per organization)

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",    "webhook_type": "message",    "valid_until": -1  }'

Body object

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

Response objectexample

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