Receive webhooks locally

Overview

Run a local server, expose it with a tunnel (e.g., ngrok), and point Blooio to the public URL.

Start a local server

server.js

import express from "express";

const app = express();
app.use(express.json());

app.post("/webhooks/blooio", (req, res) => {
  console.log("[Blooio]", req.headers["x-blooio-event"], req.body);
  res.sendStatus(200);
});

app.listen(3001, () => console.log("Listening on http://localhost:3001"));

Expose the server

ngrok http http://localhost:3001

Copy the HTTPS URL from ngrok, e.g., https://abcd1234.ngrok.io.

Configure your webhook URL

Create a new webhook using the API:

curl -X POST 'https://backend.blooio.com/v2/api/webhooks' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "webhook_url": "https://abcd1234.ngrok.io/webhooks/blooio",
    "webhook_type": "message"
  }'

You can have up to 64 webhooks per organization. Set webhook_type to "message" for message events only, or "all" for all events.

Verify deliveries

You should see incoming events in your terminal. See event schemas in Webhook events.

Managing webhooks

List all webhooks

curl -X GET 'https://backend.blooio.com/v2/api/webhooks' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Update a webhook

curl -X PATCH 'https://backend.blooio.com/v2/api/webhooks/{webhookId}' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "webhook_type": "all"
  }'

Delete a webhook

curl -X DELETE 'https://backend.blooio.com/v2/api/webhooks/{webhookId}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Rotate webhook secret

If you need a new signing secret:

curl -X POST 'https://backend.blooio.com/v2/api/webhooks/{webhookId}/secret/rotate' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Receive webhooks locally

On this page