> ## 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

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

With [incident.io](http://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](/incidents/auto-create) when an alert fires in Opsgenie using our Incident Triggers feature.

***

## Setting Up

You can connect Opsgenie to [incident.io](http://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](http://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
