- An alert triggers when an incident is created on your Statuspal status page, and recovers when the Statuspal incident ends or is deleted
- An alert triggers when a service with Statuspal’s built-in monitoring goes
down, and recovers when it isupagain
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 Statuspal 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 Statuspal 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
In Statuspal
1
Create a webhook
- Sign in to Statuspal as an admin and open the admin console of the status page you want to connect
- Click Webhooks in the sidebar, then click New Webhook
2
Enter the push URL and events
- URL: paste the full Flashduty push URL, including
integration_key - Events: select these events
incident.createdincident.updatedincident.deletedservice.monitored_status.updated(sent only for services with Statuspal’s built-in monitoring enabled)
- Click Create
3
Verify
After creating the webhook, click Send test request. Statuspal shows Flashduty’s response on the page. Statuspal does not document the body of the test request: if it creates an alert in Flashduty, close that alert manually.You can also verify with a real incident: create an incident on the status page and a Warning alert appears in Flashduty; resolve the incident and the alert recovers.
Payload
Statuspal pushes JSON. The
event field is the event type, and data.object is the Statuspal incident or service:
Incidents (incident.created, incident.updated, incident.deleted)
Service monitoring status (
service.monitored_status.updated)
Service alert titles look like
API is down. Every alert also carries the labels source=statuspal and event (the event type pushed).
Alert Key
- Incident: the incident ID. Every push for one Statuspal incident, from creation through updates to its end, lands on the same alert
- Service: the service ID. The
downanduppushes for one service land on the same alert
Status and severity
Statuspal payloads carry no incident type (major, minor) or severity, so every incident alert is Warning.
A maintenance has an end time from the moment it is created, so Flashduty treats its pushes as recoveries. There is no matching triggered alert, so no alert is created.
FAQ
Does the alert recover while the incident is in Monitoring?
Does the alert recover while the incident is in Monitoring?
No. The alert recovers only when the incident is resolved (it gets an end time) or deleted.
Why is every incident alert Warning?
Why is every incident alert Warning?
Statuspal webhooks do not send the incident type or severity. To change the severity per service, rewrite it by the
service_ids label or the alert title with an Alert Pipeline on the integration.Do I need service.monitored_status.updated without Statuspal monitoring?
Do I need service.monitored_status.updated without Statuspal monitoring?
No. This event is sent only for services with Statuspal’s built-in monitoring enabled; selecting it creates no extra alerts.
Troubleshooting
- Send test request shows an error: make sure the push URL is complete (including
integration_key) and the integration still exists - Flashduty returns an invalid parameter error: the payload has no
data.object.id, ormonitored_statusis neitherupnordown - An incident alert does not recover: make sure the incident is resolved in Statuspal and the webhook includes
incident.updated - A service alert does not recover: make sure the webhook includes
service.monitored_status.updatedand the service monitor is backup