operational or the incident is resolved.
Subscribers need no Statuspage account and pay nothing. The Webhook option appears in a page’s subscribe menu only when the page owner has enabled webhook subscriptions.
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 an integration
- Select Atlassian Statuspage and click Save
- Open the new integration card and copy the push URL
Use a shared integration
- In the Flashduty console, go to Integration Center → Alert Events
- Select Atlassian Statuspage and enter an integration name
- Configure the default route and select a channel. You can add more rules under Routes after creation
- Click Save and copy the generated push URL
Subscribe on a Statuspage status page
1
Open the subscribe menu
Open the status page you want to follow (for example,
https://www.githubstatus.com), click Subscribe to updates, and select the webhook icon.If there is no webhook option, the page owner has not enabled webhook subscriptions, and this integration cannot receive updates from that page.2
Enter the push URL
- Webhook URL: paste the full push URL of the Flashduty integration, including
integration_key - Email address: enter a team mailbox. Statuspage emails this address when the push URL returns an error
- Click Subscribe. If you receive a confirmation email, follow its instructions
3
(Optional) Subscribe to your own team's status page
If your team runs a status page on Statuspage, first go to Subscribers → Options → Settings in the Statuspage management console, select Webhook under Delivery types, and save. The webhook option then appears in the page’s subscribe menu. The Free plan can enable it too. Then subscribe as in the previous step; a page that is not activated yet can also be subscribed to by a logged-in team member, which is handy for a first check.
4
Verify
Statuspage has no button to send a test notification. An alert appears in Flashduty only after the next component status change or incident update on the page.If your team runs a Statuspage page, you can use it to verify: change a component’s status to Major outage and a Critical alert appears in Flashduty; change it back to Operational and the alert recovers. When you create an incident in Statuspage, select at least one affected component, or Statuspage sends no notification.
Payload
Statuspage posts one JSON body each time a component changes status and each time an incident is updated. There are two kinds: Component status change
The alert title looks like
API Requests: major outage.
Incident update
Every alert also carries the label
source=statuspage. The unsubscribe link in the payload (meta.unsubscribe) contains the subscription credential, and Flashduty never writes it into the alert.
Alert Key
Flashduty builds the Alert Key per payload kind:
- Component: status page ID + component ID. Every status change of one component, from outage to recovery, lands on the same alert
- Incident: status page ID + incident ID. Every update of one Statuspage incident, from
investigatingtoresolved, lands on the same alert
none to critical), Flashduty opens a new alert at the higher severity and keeps the earlier alert open; the recovery delivery closes both. After an alert recovers, a new outage of the same component opens a new alert.
Status and severity
Component status
Statuspage incidents
The alert severity comes from the impact (
impact), and the alert status from the incident status (status):
Scheduled maintenance (status
scheduled, in_progress, verifying, or completed, or impact maintenance) is planned change: Flashduty returns success and creates no alert.
FAQ
Does the alert recover while an incident is in monitoring?
Does the alert recover while an incident is in monitoring?
No.
monitoring means a fix is deployed and being watched. The alert stays triggered until the status page marks the incident resolved.A component went from an outage straight into maintenance. Why didn't the alert recover?
A component went from an outage straight into maintenance. Why didn't the alert recover?
under_maintenance is ignored and is not a recovery signal. The alert recovers when maintenance ends and the component returns to operational, or you can close it manually in Flashduty.How do I stop receiving updates from a status page?
How do I stop receiving updates from a status page?
The Statuspage unsubscribe link appears only in the payload, and Flashduty does not keep it. You can delete the Flashduty integration, or ask the status page’s owner to remove the subscription; Statuspage emails the address you entered when deliveries fail.
Troubleshooting
- The status page has no webhook subscribe option: the page owner has not enabled webhook subscriptions, so this integration cannot subscribe to it
- Flashduty returns an invalid parameter error: make sure the push URL is complete (including
integration_key). Payloads withoutpage.id, a component ID, or an incident ID are rejected - Statuspage emails that deliveries fail: Statuspage requires a 2xx response within 30 seconds. Make sure the integration still exists and the push URL has not changed
- A component’s alert does not recover: make sure the component is back to
operational; maintenance does not close the alert