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.

Note

Bleemeo automatically creates a default Webhook integration for your account.

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

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 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

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

• 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