> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incident.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Opsgenie

> Page the right people through Opsgenie without ever leaving Slack.

In an incident, at the boundaries of your knowledge and need help to figure something out? We've all been there.

With incident.io, you can use `/incident escalate` **to directly page users in Slack** — no need to log into Opsgenie, search around and find the right place!

You can also automatically trigger incidents when an alert fires in Opsgenie by [setting up Opsgenie as an alert source](https://app.incident.io/~/alerts/sources/create?source_type=opsgenie). You'll need to have connected Opsgenie as an integration first.

***

## Setting Up

You can connect Opsgenie to incident.io in just a few clicks.

*For this integration to work, your Opsgenie account will need to be on the **Standard** or **Enterprise** plan. This is a* [limitation of Opsgenie](https://docs.opsgenie.com/docs/essentials-plan-restrictions#serviceincident-operations-through-api) *, where they restrict access to the Incidents API to these tiers.*

1. **Go to Settings >** [Integrations](https://app.incident.io/~/settings/integrations)

2. **Press Install next to Opsgenie**

<img src="https://mintcdn.com/incidentio-18bb4170/_DekhBAoHG6rGVN6/images/help-centre/opsgenie/screenshot-1.png?fit=max&auto=format&n=_DekhBAoHG6rGVN6&q=85&s=5ebcabfe44784113d50e89ed70fe5520" alt="" width="2000" height="1165" data-path="images/help-centre/opsgenie/screenshot-1.png" />

3. **Fetch your API key from Opsgenie**

You'll need to create an API key by heading to the settings page of [your Opsgenie account](https://app.opsgenie.com/auth/login).

You can find this by heading to **Settings** and then scrolling down to **API key management**. The page will look something like this:

<img src="https://mintcdn.com/incidentio-18bb4170/_DekhBAoHG6rGVN6/images/help-centre/opsgenie/screenshot-2.png?fit=max&auto=format&n=_DekhBAoHG6rGVN6&q=85&s=db085655b96f0ce3bf3a0d7d5ddc4be1" alt="" width="2576" height="1618" data-path="images/help-centre/opsgenie/screenshot-2.png" />

Click *Add new API key*

* Call it "incident.io"
* Set access rights:
  * We require Read, Create, Delete, Update and Configuration access
  * We require a **Global integration** API Key
  * We don't delete resources that aren't managed by incident.io
  * We will create 2 integrations one of type `API` and another of type `Webhook`: we need the deletion permission so that we can clean up any resources we create if you were to uninstall the Opsgenie integration

<img src="https://mintcdn.com/incidentio-18bb4170/_DekhBAoHG6rGVN6/images/help-centre/opsgenie/screenshot-3.png?fit=max&auto=format&n=_DekhBAoHG6rGVN6&q=85&s=5870ff13d8cd78deaf4a714eba1a161c" alt="" width="2304" height="1528" data-path="images/help-centre/opsgenie/screenshot-3.png" />

Copy the key to your clipboard.

4. **Paste the API key** from your clipboard into the incident.io modal

<img src="https://mintcdn.com/incidentio-18bb4170/_DekhBAoHG6rGVN6/images/help-centre/opsgenie/screenshot-4.png?fit=max&auto=format&n=_DekhBAoHG6rGVN6&q=85&s=c661e2c508cf4cf0ce57fb93bcd3d0db" alt="" width="2938" height="2268" data-path="images/help-centre/opsgenie/screenshot-4.png" />

Hit Save, and you're all set up with Opsgenie!

***

## Escalating an incident

Just head over to the incident's Slack channel and hit `/incident escalate`.

<iframe src="https://www.loom.com/embed/01b7976b413947ed93d9b9d1af820173" width="100%" height="400" allowfullscreen />

**Who can I page?**

* *A team* : we'll use the settings you've defined for the team to page whoever's on-call.
* *Any user on Opsgenie* : sometimes, you know that special someone that can help you out when you get stuck. Escalate to them directly, and bring them in to help.
* *Both the above at once!* In the middle of a particularly gnarly incident? You can page multiple teams and individuals all at once
