> For the complete documentation index, see [llms.txt](https://docs.statuspal.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.statuspal.io/platform/integrations/opsgenie.md).

# OpsGenie

Automatically create and resolve Statuspal incidents from OpsGenie alerts.

Integrate OpsGenie with Statuspal to keep your status page in sync with your alerting workflow:

* Statuspal incidents are created automatically when OpsGenie incidents are triggered.
* Statuspal incidents are resolved automatically when OpsGenie incidents are resolved.
* Configure rules to control which OpsGenie severities and services map to which Statuspal services.

## How it works

Statuspal registers a webhook in OpsGenie. When an OpsGenie incident event occurs, OpsGenie notifies Statuspal, which then creates or resolves a status page incident according to your configured rules.

## Requirements

* **OpsGenie**: Admin role (required to create an API key).
* **Statuspal**: Admin or Owner role (required to configure the integration).

## Setup

### In OpsGenie

1. Go to **Integrations > Add Integration** and select **API**.
2. Ensure **Read Access**, **Create and Update Access**, and **Enabled** are all checked.
3. Click **Save Integration** and copy the **API Key**.\
   \
   ![OpsGenie API integration](https://4061983002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIMm5p2V7PNx3dS7vwKE%2Fuploads%2Fgit-blob-30d622cfc8242b4463074782ea1286a413c7b488%2Fintegrations-opsgenie-api-key.png?alt=media)

### In Statuspal

1. From your status page's dashboard, click **Integrations** in the sidebar.
2. Click **New integration** and select **OpsGenie**.
3. Enter your OpsGenie API key and click **Create**.\
   \
   ![Statuspal OpsGenie integration — empty rules](https://4061983002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIMm5p2V7PNx3dS7vwKE%2Fuploads%2Fgit-blob-462670b98aaf06a5d7e39746452cdc5aa96a99b0%2Fintegrations-opsgenie-empty-rules.png?alt=media)

## Configuring rules

Rules determine which OpsGenie incidents trigger Statuspal status updates and how they map to your services. For each rule, configure:

* **OpsGenie severity** to match on.
* **Statuspal service(s)** to affect.
* **Incident type** to create in Statuspal.

![OpsGenie rule configuration](https://4061983002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIMm5p2V7PNx3dS7vwKE%2Fuploads%2Fgit-blob-5e59155e0172e0836a0b1d03242bedde3ee51f3e%2Fintegrations-opsgenie-rule-config.png?alt=media)

Once one or more rules are saved, incidents will be automatically created and resolved based on your OpsGenie activity.

![Configured OpsGenie rule](https://4061983002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIMm5p2V7PNx3dS7vwKE%2Fuploads%2Fgit-blob-bacee7a0a8dee2a9c9d4145950a5d967f948c8c2%2Fintegrations-opsgenie-configured-rule.png?alt=media)

## Uninstalling

In your Statuspal admin, click **Integrations**, find the OpsGenie integration, click **Delete**, and confirm. The integration and its webhook in OpsGenie will be permanently removed.