---
title: "StatusPage integration for Grafana IRM | Grafana Cloud documentation"
description: "Configure StatusPage integration for Grafana IRM to automate status updates during incidents"
---

# StatusPage integration for Grafana IRM

The StatusPage integration for Grafana IRM helps you provide consistent and reliable updates to your customers during incidents. By linking your StatusPage.io account, you can automatically create StatusPage incidents when you declare incidents in IRM, ensuring timely communication with your users.

## Key benefits

- Automatically creates StatusPage incidents when IRM incidents are declared
- Maintains consistent messaging across internal and external communications
- Reduces manual work during critical incidents
- Helps mitigate the volume of customer support inquiries during outages
- Streamlines post-incident communications

## Before you begin

To use the StatusPage integration, you need:

- A StatusPage.io account with administrative access
- Your StatusPage Page ID (found in your StatusPage URL: `https://manage.statuspage.io/pages/<PAGE_ID>`)
- A StatusPage API key with appropriate permissions
- The Grafana Admin org role assigned

## Configure the StatusPage integration

To install and configure the StatusPage integration:

1. In Grafana, navigate to **Alerts &amp; IRM** &gt; **IRM** &gt; **Integrations**.
2. Select **Apps**.
3. Locate and click **StatusPage**.
4. Click **Install Integration**.
5. Enter your StatusPage Page ID and API key.
6. Click **Save**.

## Configure event triggers

After installation, configure when the integration creates a StatusPage incident.

1. From the StatusPage integration settings, click **+ Run when an event fires** under the **Create an incident** action.
2. From the **Run this action when** dropdown, select an event trigger.
3. If you have the [Grafana Cloud app for Slack](/docs/grafana-cloud/alerting-and-irm/irm/integrations/chat-and-collaboration/slack) installed, optionally enable **Run this action on private incidents** to include private incidents.
4. Click **Save**.

The following event triggers are available:

- **Incident is declared**: Creates a StatusPage incident whenever a new incident is declared in IRM.
- **Incident changes**: Creates a StatusPage incident whenever an existing incident is updated.
- **Manually triggered through the UI**: Allows you to manually trigger StatusPage incident creation from the incident details view.
- **Incident matches a filter**: Creates a StatusPage incident only when an incident matches a filter expression using [incident query syntax](/docs/grafana-cloud/alerting-and-irm/irm/reference/incident-query-syntax). When selected, an additional **Filter** field appears for you to enter the filter expression.

For example, to create a StatusPage incident only for critical severity incidents, select **Incident matches a filter** and enter the following filter:

![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```none
severity:critical
```

## Using the integration

Once configured, the integration:

- Automatically creates a StatusPage incident when an incident is declared in IRM
- Uses the IRM incident title as the StatusPage incident name
- Links the StatusPage incident to your IRM incident for reference
- Updates the StatusPage incident title when the IRM incident title changes

You can also click the StatusPage link in the incident details to open and update the incident directly in StatusPage.

## Limitations

The native StatusPage integration provides basic incident creation functionality. The integration does not support:

- Selecting specific StatusPage components to associate with the incident
- Setting incident visibility or impact level
- Customizing the initial incident status or message body

For more granular control over StatusPage incident creation, including component selection and impact settings, use [outgoing webhooks](/docs/grafana-cloud/alerting-and-irm/irm/integrations/custom-integrations/outgoing-webhooks) to call the StatusPage API directly.

## Next steps

- [Incident query syntax](/docs/grafana-cloud/alerting-and-irm/irm/reference/incident-query-syntax)
- [Outgoing webhooks](/docs/grafana-cloud/alerting-and-irm/irm/integrations/custom-integrations/outgoing-webhooks)
- [StatusPage.io documentation](https://support.atlassian.com/statuspage/)