---
title: Opsgenie
slug: opsgenie
docTags: 
createdAt: 2023-06-27T07:42:19.980Z
---

# Purpose

Echoes can connect to your Opsgenie and monitor your incidents lifecycle in order to produce some metrics such as the [Mean time to recovery](docId\:lGfIZtDECxM2tQ2KurlIp).

# Installation

You need an Opsgenie API key. Go to the [Opsgenie API Key Management page](https://support.atlassian.com/opsgenie/docs/api-key-management/) and click **Add new API key**.

## Required permissions

::::VerticalSplit{layout="middle"}
:::VerticalSplitItem
::Image[]{src="https://api.archbee.com/api/optimize/cnN9HGi_h1eJLSFAvJkF4/ZbpGYwWCJaW7K1Ctw0cYy_screenshot-2023-06-27-at-102848.png" size="80" width="382" height="246" position="center" caption="Access rights" alt="Access rights" showCaption="true"}
:::

:::VerticalSplitItem
On the API Access page, check the "Access rights" boxes for **Read **and** Configuration access.**
:::
::::

## Connect to Echoes

::::VerticalSplit{layout="middle"}
:::VerticalSplitItem
::Image[]{src="https://api.archbee.com/api/optimize/cnN9HGi_h1eJLSFAvJkF4/utL0_W4dsNiP95YZ2wRNc_screenshot-2023-06-27-at-095325.png" size="76" width="462" height="704" position="center" showCaption="false"}
:::

:::VerticalSplitItem
Go to Echoes's integrations page and click on the Opsgenie integration card
:::
::::

![Installation](https://api.archbee.com/api/optimize/cnN9HGi_h1eJLSFAvJkF4/SrVTAXS2fZsUoIJwIaXZx_screenshot-2023-06-27-at-094246.png "Installation")

1. Enter the Opsgenie API key that was just generated.
2. Change the **region** if different from US.

   After configuring the Opsgenie API key, you need to configure an outgoing webhook so Echoes can correctly sync incident states between Opsgenie and Echoes.

3. Copy the webhook address provided by Echoes and head to [https://app.opsgenie.com/settings/integration/add/Webhook/](https://app.opsgenie.com/settings/integration/add/Webhook/)

![Webhook configuration](https://api.archbee.com/api/optimize/cnN9HGi_h1eJLSFAvJkF4/bl3LOhA9eCT4L-HxzMa15_screenshot-2023-06-27-at-105457.png "Webhook configuration")

::::VerticalSplit{layout="middle"}
:::VerticalSplitItem
::Image[]{src="https://api.archbee.com/api/optimize/cnN9HGi_h1eJLSFAvJkF4/qRwLWO5sLX394lJdfrG99_screenshot-2023-06-27-at-105848.png" size="80" width="508" height="140" position="center" showCaption="false"}
:::

:::VerticalSplitItem
1. Click on **Add custom headers **on the webhook integration settings page.
2. Add the **Payload-Signature **header with the secret provided by Echoes as value.


:::
::::

::::VerticalSplit{layout="middle"}
:::VerticalSplitItem
::Image[]{src="https://api.archbee.com/api/optimize/cnN9HGi_h1eJLSFAvJkF4/Xn9WzsmG9sZX0y8CgifVE_screenshot-2023-06-27-at-152722.png" size="80" width="434" height="122" position="center" showCaption="false"}
:::

:::VerticalSplitItem
     3.Tick the** Add Alert Details to Payload **checkbox.

     4.Hit Save.
:::
::::



![Webhook header](https://api.archbee.com/api/optimize/cnN9HGi_h1eJLSFAvJkF4/hdfrNi6CWPxCiqFF2myc4_screenshot-2023-06-27-at-110028.png "Webhook header")