Uptime Kuma Integration

Uptime Kuma can trigger Crit Alarm using either its built-in ntfy notification provider or a custom Webhook.

Method 1: Built-in ntfy Provider (Recommended)

In Uptime Kuma, navigate to Settings -> Notifications and click Setup Notification.

Fill in the exact fields in the modal:

Field Name in UI	Value / Setting	Notes
Notification Type	ntfy	Choose from the dropdown menu.
Friendly Name	Crit Alarm - Production	A descriptive label for this notification target.
ntfy Server / URL	https://alerts.example.com	Your Crit Alarm base URL. Do not append the topic name or a trailing slash here.
Topic	prod	The topic created on your Crit Alarm server.
Authentication	Bearer Token	Select the Bearer authentication method.
Password / Token	tk_xxxxxxxxxxxx	Paste the topic publish token obtained when creating the topic.
Priority	5 (Urgent / Max)	Required for alarms. Priority 5 triggers an emergency incident on critical topics.
Default enabled	Checked (optional)	Automatically enables this notification for newly created monitors.

---

Method 2: Custom Webhook Provider

If you prefer using generic webhooks or want custom JSON formatting:

In Uptime Kuma, navigate to Settings -> Notifications and click Setup Notification.

Fill in the exact fields in the modal:

Field Name in UI	Value / Setting	Notes
Notification Type	Webhook	Choose from the dropdown menu.
Friendly Name	Crit Alarm Webhook	Descriptive label.
Post URL	https://alerts.example.com/prod	Base URL combined with your topic name.
Request Method	POST	Default HTTP verb.
Content Type	application/json	JSON format.
Additional Headers	See the headers JSON in this section	Enter custom headers as a JSON object.

Additional Headers JSON

Enter the following into the Additional Headers field:

{
  "Authorization": "Bearer tk_xxxxxxxxxxxx",
  "X-Priority": "5",
  "X-Title": "Uptime Kuma Monitor Alert"
}

---

Testing the Alarm

Before saving, verify the integration:

1. Click the Test button at the bottom of the notification dialog in Uptime Kuma.
2. Uptime Kuma sends a test dispatch to POST /prod with priority 5.
3. Observe your phone:
   • Your phone should ring immediately with the Crit Alarm siren.
   • The notification should show the incident title and test body.
4. Click Save in Uptime Kuma to commit the notification target.