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
- In the Flashduty console, go to Channels and open a channel
- Select Configuration → Integrations → Private integration, then click Add integration
- Select Uptimia and click Save
- Open the generated integration card and copy the Push URL
Use a shared integration
- In the Flashduty console, go to Integration Center → Alert Events
- Select Uptimia and enter an integration name
- Configure the default route and select a channel. You can add more rules under Routing after creation
- Click Save and copy the generated Push URL
In Uptimia
1
Create a webhook integration in Uptimia
Where: Uptimia › Alerting › Integrations › Add Integration › Webhooks
Click 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 asapplication/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 usesmonitor_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
Do duplicate deliveries create several Flashduty alerts?
Do duplicate deliveries create several Flashduty alerts?
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.How are recoveries of grouped alerts handled?
How are recoveries of grouped alerts handled?
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.Uptimia says the test succeeded, but Flashduty shows no alert?
Uptimia says the test succeeded, but Flashduty shows no alert?
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_typeandid, and thatmonitor_statusisdownorup - No alert arrives: confirm the monitor has the webhook contact ticked and is not paused