Skip to main content
Use an Uptimia webhook integration to send monitor down (down) and recovery (up) notifications to Flashduty On-call. Each Uptimia monitor maps to one Flashduty alert: the alert triggers when the monitor goes down, severity changes and repeated notifications merge into the same alert, and the alert recovers when the monitor is up again.

In Flashduty On-call

You can get the integration push URL in either of the following ways.

Use a dedicated integration

  1. In the Flashduty console, go to Channels and open a channel
  2. Select Configuration → Integrations → Private integration, then click Add integration
  3. Select Uptimia and click Save
  4. Open the generated integration card and copy the Push URL

Use a shared integration

  1. In the Flashduty console, go to Integration Center → Alert Events
  2. Select Uptimia and enter an integration name
  3. Configure the default route and select a channel. You can add more rules under Routing after creation
  4. Click Save and copy the generated Push URL

In Uptimia

1

Create a webhook integration in Uptimia

Where: Uptimia › Alerting › Integrations › Add Integration › WebhooksClick Save Integration. Every plan, including the free plan, can create webhooks.
2

Attach the contact to your monitors in Uptimia

Where: Uptimia › the monitor’s edit page › Main tab › Alerting cardIn the left pane of the Alerting card, confirm the Flashduty contact is ticked and appears in the resolved-recipients pane on the right, then click Save Monitor. New monitors default to All my contacts (current and future), so the Flashduty contact is attached automatically; you only need to tick it yourself after unticking that option to pick contacts one by one. One contact can be attached to many monitors. Uptimia sends an up notification to the same contact on recovery, so no separate recovery setup is needed.
3

Verify the lifecycle

Where: Uptimia › Alerting › Integrations (the integration’s row › Actions menu › Test)The Test button is greyed out until the integration is saved. It only verifies connectivity and creates a separate Info test alert in Flashduty (see the note below). Then make a monitor actually fail (for example, point it at an unreachable address) and confirm that Flashduty receives an active alert. Restore the target and confirm the same alert recovers.
The request sent by Actions → Test in Uptimia’s integration list (monitor_status and severity are both test, id is 1, monitor_name is Test monitor, the three incident_* fields are the string None, and message starts with “Congratulations”) opens a separate Info alert in Flashduty. It never merges with a real alert and does not recover, so close it by hand. The “Test notification sent successfully” message only means Uptimia sent the request, not that Flashduty accepted it.

Payload

Uptimia POSTs a fixed set of 11 fields as application/json. Flashduty parses them directly, with no template to configure: When alert groups are enabled, Uptimia adds a group object on top of the same 11 fields (the fields describe the first failed monitor in the group). Flashduty processes the 11 fields and stores group.id and group.size as labels group_id and group_size.

Alert key

Flashduty uses monitor_type together with id as the Alert Key. Uptimia numbers id separately within each monitor type, so it must be paired with monitor_type; the payload has no incident ID. Down, severity change, repeated notification, and recovery for one monitor carry the same two fields and land on the same alert. Renaming the monitor or changing its note, severity, or times does not change the Alert Key. If monitor_type or id is missing, Flashduty returns a parameter error, because a recovery could not be matched reliably to its alert.

Status and severity

Requests whose monitor_status is empty or any other value are rejected, so a request with an unknown state never enters the wrong alert lifecycle.

FAQ

No. Uptimia delivers at least once and retries a failed delivery up to 5 times. Duplicates carry the same monitor_type and id, so they merge into one alert.
Uptimia sends one recovery notification when the last member of a group recovers, and its fields describe a monitor in the group. Flashduty recovers only the alert that matches that notification’s monitor_type and id; other monitors in the group may not receive a recovery of their own. If an alert stays open, close it by hand in the channel, or configure auto-close on timeout for the integration.
That message only means Uptimia sent the request. Check that the Webhook URL is the full push URL including integration_key, and look in Flashduty for an Info alert titled “Uptimia test notification”.

Troubleshooting

  • Uptimia reports a failed delivery: confirm the Webhook URL is the full push URL. Flashduty returns 2xx on success
  • Flashduty returns a parameter error: confirm the body contains monitor_type and id, and that monitor_status is down or up
  • No alert arrives: confirm the monitor has the webhook contact ticked and is not paused
For the field reference, see the Uptimia Webhook payload reference.