# Alerting - Webhooks

### Overview

Highlight can send outbound alerts via a webhook, enabling easier integration with service management tools and other systems. Typically you will only be setting up this type of alerting if you are an administrator or engineer responsible for interconnecting a number of separate platforms.

### Alert Setup

In the Create Alert dialog box (example below) two specific fields for setting up webhook alerts are:

<table><thead><tr><th width="137"></th><th></th></tr></thead><tbody><tr><td><strong>Method</strong></td><td>Webhook</td></tr><tr><td><strong>Send to</strong></td><td>Enter a URL generated by the webhook receiver (required field)</td></tr><tr><td>Test button</td><td>Is available for webhook alerts only and sends a sample webhook (see next section) to the URL</td></tr><tr><td><mark style="color:green;">Connected</mark></td><td>Testing confirms the URL is valid </td></tr><tr><td><mark style="color:red;">Cannot connect</mark></td><td>Shown if the URL is not valid, for possible reasons refer to <a href="https://support.highlight.net/help/troubleshoot/alerting#symptom_7_webhook_alert_issues"><mark style="color:red;">Troubleshooting webhook alerts</mark></a></td></tr><tr><td><strong>Notify on failure</strong></td><td><p>Shows your email address by default but can be changed. Separate multiple addresses with commas.<br>If there's a problem with a webhook, Highlight sends an email to this address with this information:</p><ul><li>Subject: Webhook endpoint temporarily disabled</li><li>Webhook name</li><li>Webhook ID</li><li>Webhook URL</li><li>Link to webhook</li><li>Reason for failure</li></ul><p>This field is optional. Delete the email address if you do not wish to receive an email.</p></td></tr><tr><td><strong>Save button</strong></td><td>On save, a unique ID number is created for each alert allowing you to track who made changes to an alert. The ID is visible in the alerting table, when editing an alert and in Reporting Audit Log as the item name.<br>When saving a webhook alert, a test of the <strong>Send to</strong> URL is performed. This test must be successful to save the alert.</td></tr></tbody></table>

Refer to the [alerting page](/status/alerting/alerting-email.md) for details on all other fields in the create/edit dialog.

### Webhook output format

Webhook alerts contain the information shown below. Note: This is a sample designed to show all possible fields but not a realistic webhook.

```
[
{
"activeLinkedSites": 2,
"alertIds": "297402",
"alertLinkUrl": "https://kfv-services.highlighter.net/portal/index.html#/status/alerting/19739/%7b%22editItemId%22%3a57661%7d",
"alertNames": "Cellular Alert",
"alertSummary": "KFV Services - Red Alert Raised - LinkHealthADSL (HO-Secondary)",
"broadbandDownstreamSpeedKbps": "5272",
"broadbandAlertThresholdKbps": "2048",
"cellularSignalStrength": "3.2",
"cellularSignalThreshold": "3.8",
"colour": "Red",
"criticalPort": 1,
"criticalSlot": 2,
"deviceAddress": "10.0.0.1",
"direction": "Up",
"downLinkedSites": false,
"folder": "KFV Services >> DataCentre",
"fuelGaugeValue": 110,
"hasCriticalPortInfo": true,
"hasStabilityIssue": true,
"isBroadbandSpeedAlert": false,
"isSiteLink": true,
"isTunnel": true,
"isWirelessAccessPoint": false,
"level3Metric": "Stability",
"level2Metric": "LinkStability",
"linkUrl": "https://kfv-services.highlighter.net/portal/index.html#/details/landing/19739/23298/%257B%2522today%2522%253Atrue%257D",
"locationName": "Head Office",
"metricDescription": "Link Stability",
"metricValue": 120,
"portInterfaceAlias": "Link to SG500-28",
"portInterfaceName": "GigabitEthernet1/0/44",
"problem": "Link-Availability - Red alert raised",
"referenceText": "1067504-1718672",
"siteLinksUp": 1,
"stabilityIssueCode": "#DRP",
"stabilityIssueDescription": "Device restarted powered off/on",
"text": "KFV Services - Red Alert Raised - LinkHealthADSL (HO-Secondary)",
"timeStampAtWatchLocation": "2020-02-14T12:23:26.4304015+02:00",
"timeStampUtc": "2020-02-14T10:23:26.4304015Z",
"totalLinkedSites": 1,
"tunnelTrafficLoadPercent": 90,
"tunnelTrafficLoadThresholdPercent": 82,
"wapLocation": "WapLocation",
"wapSerialNumber": "WapSerialNumber",
"watchName": "HO-Secondary",
"watchTypeName": "WatchTypeName"
}
]
```

Additional information on webhook fields:

<table data-full-width="false"><thead><tr><th width="184">Field ID</th><th>Example contents</th><th>Notes</th></tr></thead><tbody><tr><td>activeLinkedSites</td><td>2</td><td>integer</td></tr><tr><td>alertIds</td><td>297402</td><td>integer</td></tr><tr><td>alertLinkUrl</td><td>https://kfv-services.highlighter.net/portal/index.html#/status/alerting/19739/%7b%22editItemId%22%3a57661%7d</td><td>string URL link to the alert in Highlight, users can follow for direct access</td></tr><tr><td>alertNames</td><td>Cellular Alert</td><td>may be empty, otherwise string</td></tr><tr><td>alertSummary</td><td>KFV Services - Red Alert Raised - LinkHealthADSL (HO-Secondary)</td><td>combined string showing Location - Colour Raised/Cleared - Watch Name</td></tr><tr><td>broadbandDownstreamSpeedKbps</td><td>5272</td><td>always empty if IsBroadbandSpeedAlert is false, otherwise integer</td></tr><tr><td>broadbandAlertThresholdKbps</td><td>2048</td><td>always empty if IsBroadbandSpeedAlert is false, otherwise integer</td></tr><tr><td>cellularSignalStrength</td><td>3.2</td><td>always empty if IsCellular is false, otherwise decimal</td></tr><tr><td>cellularSignalThreshold</td><td>3.5</td><td>always empty if IsCellular is false, otherwise decimal</td></tr><tr><td>colour</td><td>Red</td><td>red, amber or green</td></tr><tr><td>criticalPort</td><td>2</td><td>integer, this field only appears if a value has been set</td></tr><tr><td>criticalSlot</td><td>2</td><td>integer, this field only appears if a value has been set</td></tr><tr><td>deviceAddress</td><td>10.0.0.1</td><td>IP address</td></tr><tr><td>direction</td><td>up</td><td>up (active) or down (inactive)</td></tr><tr><td>downLinkedSites</td><td>false</td><td>boolean: true if watch is a site link and down</td></tr><tr><td>folder</td><td>KFV Services » DataCentre</td><td>path with “»” as separator</td></tr><tr><td>fuelGaugeValue</td><td>110</td><td>interger</td></tr><tr><td>hasCriticalPortInfo</td><td>true</td><td>boolean: true or false</td></tr><tr><td>hasStabilityIssue</td><td>true</td><td>boolean: true or false</td></tr><tr><td>isBroadbandSpeedAlert</td><td>false</td><td>boolean: true or false</td></tr><tr><td>isSiteLink</td><td>true</td><td>boolean: true or false</td></tr><tr><td>isTunnel</td><td>true</td><td>boolean: true or false</td></tr><tr><td>isWirelessAccessPoint</td><td>false</td><td>boolean: true or false</td></tr><tr><td>level3Metric</td><td>Stability</td><td>stability, load or health</td></tr><tr><td>level2Metric</td><td>Link Stability</td><td>see <a href="/pages/ybu3FjwiK54UMOXj5A5R#problem-text-in-alerts">Problem text in alerts</a> for examples</td></tr><tr><td>linkUrl</td><td>https: //kfv-services.highlighter.net/portal/index.html#/details/landing/19739/23298/%257B%2522today%2522%253Atrue%257D</td><td>string URL link to watch in Highlight, users can follow for direct access</td></tr><tr><td>locationName</td><td>Head Office</td><td>string</td></tr><tr><td>metricDescription</td><td>Link Stability</td><td>string</td></tr><tr><td>metricValue</td><td>120</td><td>integer</td></tr><tr><td>portInterfaceAlias</td><td>Link to SG500-28</td><td>string</td></tr><tr><td>portInterfaceNamw</td><td>GigabitEthernet1/0/44</td><td>string</td></tr><tr><td>problem</td><td>Link-Availability - Red alert raised</td><td>string</td></tr><tr><td>referenceText</td><td>1067504-1718672</td><td>string</td></tr><tr><td>siteLinksUp</td><td>1</td><td>the number of site links in the same location still up, set to <code>null</code> if the watch is not a site link</td></tr><tr><td>stabilityIssueCode</td><td>#DRP</td><td>can be empty, see <a href="/pages/ybu3FjwiK54UMOXj5A5R#stability-issue-codes">full list of stability issue codes</a></td></tr><tr><td>stabilityIssueDescription</td><td>Device restarted powered off/on</td><td>can be empty, see <a href="/pages/ybu3FjwiK54UMOXj5A5R#stability-issue-codes">full list of stability issue descriptions</a></td></tr><tr><td>text</td><td>KFV Services - Red Alert Raised - LinkHealthADSL (HO-Secondary)</td><td>combined string showing Location - Colour Raised/Cleared - Watch Name (same as alertSummary)</td></tr><tr><td>timeStampAtWatchLocation</td><td>2020-02-14T12: 23: 26.4304015+02: 00</td><td>(Date) YYYY-MM-DD T (Time) HH:MM:SS.sssssss + offset from UTC in HH:MM</td></tr><tr><td>timeStampUtc</td><td>2020-02-14T10: 23: 26.4304015+00: 00</td><td>(Date) YYYY-MM-DD T (Time) HH:MM:SS.sssssss Z</td></tr><tr><td>totaLinkedSites</td><td>1</td><td>integer</td></tr><tr><td>tunnelTrafficLoadPercent</td><td>90</td><td>integer - percentage</td></tr><tr><td>tunnelTrafficLoadThresholdPercent</td><td>82</td><td>integer - percentage - fixed value</td></tr><tr><td>wapLocation</td><td>WapLocation</td><td>string, always empty if IsWirelessAccessPoint is false</td></tr><tr><td>wapSerialNumber</td><td>WapSerialNumber</td><td>string, always empty if IsWirelessAccessPoint is false</td></tr><tr><td>watchName</td><td>HO-Secondary</td><td>string</td></tr><tr><td>watchTypeName</td><td>WatchTypeName</td><td>string</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.highlight.net/status/alerting/alerting-webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.