Send Cloudmon alarm notifications to any webhook endpoint. Custom hooks allow you to integrate Cloudmon with any system that accepts HTTP callbacks, enabling customized notification and automation workflows beyond the built-in integrations.
The Custom Hook integration sends an HTTP payload to a URL of your choice whenever an alarm fires in Cloudmon. This makes it possible to connect Cloudmon to any system that exposes a webhook endpoint, including internal automation tools, custom dashboards, ticketing systems not natively supported, or any platform that can receive and process HTTP requests.
To open, update, and close tickets in a tool with a REST API, see Custom Integration.
| Field | Description |
| Name* | A display name to identify this webhook in Cloudmon, such as "Internal Automation" or "Custom Alert Receiver". |
| Hook URL* | The HTTP method, POST by default or GET, and the webhook endpoint URL that Cloudmon sends the request to when the alarm fires. The URL must be reachable from the Cloudmon controller. |
| Verify SSL Certificate | Select to verify the SSL certificate of the endpoint. |
| Data Type* | How the request body is encoded: Form Data, Form URL Encoded, or Raw. Raw is the default. |
| Content Type | The format of a raw body: JSON, XML, Text, HTML, or None. |
| Request Headers | Extra headers to send, as name and value pairs. Add each one with the plus icon. The Content-Type header is added automatically. |
| Body Content | The request body. Type $ to insert a replaceable tag with alarm or device details. See Replaceable Tags. Leave it empty to send the default alarm payload. |
| User Agent | An optional user agent string for the request. |
| Time Out (sec) | How long Cloudmon waits for the endpoint to respond, in seconds. |
| Authentication | No Authentication or Basic Authentication. With Basic Authentication, enter the Username and Password the endpoint expects. |
Replaceable tags insert alarm and monitor details into the request body when the request is sent. In Body Content, type $ to open the tag list, search for a tag, and select it. For example:
{
"summary": "$message",
"severity": "$severity",
"source": "$device_ip",
"customer": "$customer_name",
"groups": "$device_groups",
"tags": "$device_tags"
}The list offers the following tags under Alarm Properties.
| Tag | Name in the list |
$message | Message |
$severity | Severity |
$category | Category |
$status | Status |
$metric | Metric |
$currentValue | Current Value |
$threshold | Threshold |
$reason | Reason |
$createdAt | Created At |
$alarmId | Alarm Id |
$customer | Customer |
$customer_id | Customer Id |
$cleared_by | Cleared By |
$clear_message | Clear Message |
It offers the following tags under Monitor Properties.
| Tag | Name in the list |
$device_name | Display Name |
$device_type | Monitor Type |
$device_ip | IP Address |
$device_hostname | Host Name |
$device_category | Category |
$device_os | Operating System |
$device_vendor | Vendor |
$device_last_polled_at | Last Polled At |
$device_depend_on_monitors | Dependent Monitors |
$device_groups | Monitor Groups |
$device_tags | Monitor Tags |
$customer_name | Customer Name |
When this alarm fires, Cloudmon sends the request to the configured Hook URL, with your body content or, if it is empty, the default alarm payload.