Webhooks Integration Guide

Webhooks + UptimeObserver Benefits

Integrating UptimeObserver with Webhooks enables real-time, automated communication between your uptime monitoring and external services.

Support

If you need help with this integration please reach out to us using the "Need Help?" button on the buttom right corner or send us an email at support@uptimeobserver.com.

Integration Walkthrough

Go to UptimeObserver and log in to your account.
Navigate to the Integrations section from your dashboard.
Select Webhooks from the list of available integration options.
You’ll need to create two webhooks:
1. One for declaring an incident
2. Another for resolving an incident

1. Incident Webhook Setup

Incident Webhook should be used by the Monitor Down event.

Friendly name : Declare Incident WH
URL : the webhook URL
HTTP Method : POST
Authentication : None. If you need to authenticate you can chose Basic Auth or Bearer.
HTTP Body Encoding : application/json

HTTP Body : Make sure you customize the body to match your target webhook.

{
    incident_url: "__INCIDENT_URL__",
    incident_id: __INCIDENT_ID__,
    title: "Incident on __MONITOR_FRIENDLY_NAME__",
    description: "Incident on __MONITOR_FRIENDLY_NAME__. Root Cause: __INCIDENT_ROOT_CAUSE__",
    incident_status: "__INCIDENT_STATUS__",
    monitor_id: __MONITOR_ID__,
    monitor_name: "__MONITOR_FRIENDLY_NAME__",
    monitor_url: "__MONITOR_URL__"
}

7.Click Save Webhook, then test it using the Test Button 🧪.

2. Resolution Webhook Setup

Resolution Webhook should be used by the Monitor Up event.

Friendly name : Resolve Incident WH
URL : the webhook URL
HTTP Method : POST
Authentication : None. If you need to authenticate you can chose Basic Auth or Bearer.
HTTP Body Encoding : application/json

HTTP Body : Make sure you customize the body to match your target webhook.

{
    incident_url: "__INCIDENT_URL__",
    incident_id: __INCIDENT_ID__,
    title: "Incident on __MONITOR_FRIENDLY_NAME__",
    description: "Incident on __MONITOR_FRIENDLY_NAME__. Root Cause: __INCIDENT_ROOT_CAUSE__",
    incident_status: "__INCIDENT_STATUS__",
    monitor_id: __MONITOR_ID__,
    monitor_name: "__MONITOR_FRIENDLY_NAME__",
    monitor_url: "__MONITOR_URL__"
}

7.Click Save Webhook, then test it using the Test Button 🧪.

Once completed, your Webhook integration is ready to automatically manage incidents in real-time!

3. Add alerts to your monitor

After configuring your webhooks, follow these steps to add alerts to your monitor:

Navigate to your monitor.
Scroll down to the Monitor Alerts section.
Click Add Alert.
Set the following parameters:
1. Alert Type: Webhook
2. Event: Monitor Up
3. Webhook: Declare Incident Webhook
Click Save Changes.
Repeat the process to add another alert with the same settings for Resolve Incident WH webhook.

Everything is now set up—your webhooks will be triggered automatically based on the selected monitor events.

How to Uninstall

In UptimeObserver:

Go to UptimeObserver and log in to your account.
Navigate to the Integrations section from your dashboard.
Select Webhooks from the list of available integration options.
Delete the webhooks