Send alert events and trigger incidents via the Statuspage API to automate status updates from monitoring pipelines

Steps

1. Create a Statuspage automation token: navigate to Manage Account > API and generate a page-scoped automation token for use in scripts
2. Map monitoring alerts to component IDs: GET /v1/pages/{page_id}/components to retrieve all component IDs; build a lookup map from service/component name to Statuspage component ID in your alerting glue code
3. On alert fire: POST /v1/pages/{page_id}/incidents with status: investigating, body with the alert summary, and components hash mapping affected component IDs to partial_outage or major_outage
4. On alert resolve: PATCH /v1/pages/{page_id}/incidents/{incident_id} with status: resolved and a resolution body; set component_ids to reset them to operational
5. Configure subscriber notifications: set deliver_notifications: true on incident creation to immediately notify email and webhook subscribers
6. Implement idempotency: store the Statuspage incident_id in your alerting system when creating; on subsequent alerts for the same issue, update the existing incident rather than creating a new one