Skip to content
BleemeoBleemeo

Webhook

Free
Starter
Professional

Send alerts to any HTTP endpoint via webhook. Build custom integrations, trigger automation workflows, or connect Bleemeo to services that aren't directly supported.

1

Prepare Your Endpoint

Set up an HTTP endpoint that can receive POST requests. Your endpoint should:

  • Accept JSON payloads via HTTP POST
  • Return a 2xx status code to acknowledge receipt
  • Be accessible from Bleemeo’s servers
2

Create an Integration (Optional)

A default Webhook integration is already available. To create additional integrations:

  1. Go to the Integrations page
  2. Click Add Integration and select Webhook
  3. Give it a descriptive name
Webhook integration in Bleemeo
3

Configure Notification Rules

  1. Go to Notifications
  2. Create a new rule or edit an existing one
  3. In the Targets step, select your Webhook integration
  4. Enter the URL of your endpoint
Webhook notification rule

Webhook Payload

Section titled “Webhook Payload”

Bleemeo sends a JSON payload with event details via HTTP POST. Here’s an example:

{
  "id": "dbe276e4-4b47-48dd-8469-e3e358224178",
  "account": "8f63c7da-700c-4fa6-a4d5-c15db2652d15",
  "agent": "951df56d-d5dd-58c3-ab9a-8f2c8a6e478b",
  "metric": "4bec41e4-4efc-4bb8-b872-186aa54779a6",
  "status": 0,
  "status_text": "OK",
  "text": "Current value: 0.00",
  "title": "voip01.example.com - Pending system security updates is OK",
  "status_changed_at": "2017-03-30T13:59:19Z",
  "previous_status_changed_at": "2017-03-30T13:56:19Z",
  "number_status_change_last_hour": 2,
  "has_been_notified": true,
  "created_at": "2017-03-30T13:59:22.268468Z",
  "created_by": null,
  "modified_at": "2017-03-30T14:00:35.061088Z",
  "modified_by": null,
  "happened_at": "2017-03-30T13:59:19Z"
}

Key Fields

Section titled “Key Fields”
Field Description
status Numeric status: 0 (OK), 1 (Warning), 2 (Critical), 3 (Unknown)
status_text Human-readable status
title Alert summary including host and metric
text Additional details about the alert
status_changed_at When the status changed
happened_at When the event occurred

Tips

Section titled “Tips”
  • Secure your endpoint: Use HTTPS and consider implementing authentication
  • Handle retries: Bleemeo may retry failed deliveries, so make your endpoint idempotent
  • Log payloads: Store incoming webhooks for debugging and audit purposes