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

# Opsgenie

## OpsGenie + Multitudes Integration Benefits

* See [`Mean Time To Recovery`](/metrics-and-definitions/process-metrics/quality-of-work/mean-time-to-recovery.md) for OpsGenie incidents

## How it works

Incident-related events from OpsGenie (such as an incident being triggered, assigned, acknowledged, and resolved) will be sent to Multitudes. This data is then processed by our data pipelines and shown in the Multitudes app.

## Requirements

In order to install this integration, you must have both:

* Owner or Manager level [permissions](/configuration-and-setup/permissions-and-roles.md) on Multitudes, and
* Account owner or Global Admin access to generate the API key in OpsGenie 

## How to install

* In the Multitudes app, go to [Settings > Integrations](https://app.multitudes.co/team-settings/integrations) and click on the connect Opsgenie card. This should direct you to your Opsgenie instance (otherwise click [here](https://app.opsgenie.com/alert/list))
* On Opsgenie navigate to settings > API key management > add a new API key

  <figure><img src="https://cdn.prod.website-files.com/610c8a14b4df1ae46b1a13a3/6406b307a039e57dd4334233_OpsGenie.png" alt=""><figcaption></figcaption></figure>
* Once you click add a new API key, you should get a pop-up. Proceed to do 3 things in the pop-up

<figure><img src="https://cdn.prod.website-files.com/610c8a14b4df1ae46b1a13a3/6406b3073e750f7044e6d14e_image%20(1).png" alt=""><figcaption></figcaption></figure>

1. Select both the "Read" and “Configuration access” access scopes
2. Copy the key - we also recommend you store this API access key in a secure location
3. Click  "Add API Key" to finalize

* Back on Multitudes, paste the previously-copied API key into the text field and click save
* You will be prompted to link Opsgenie users with Multitudes users. This will determine whose Opsgenie data we know to show in Multitudes, so it's important to complete this step. [Learn more about user linking](/configuration-and-setup/user-linking.md).
* All done! Multitudes will now start to track your incidents and calculate `Mean Time to Restore`

{% hint style="warning" %}
Multitudes tracks MTTR by looking at your Opsgenie `incidents`. It does **not** look at Opsgenie `alerts`. The Opsgenie `incidents` feature is only available to paying Opsgenie customers.
{% endhint %}