# Integrate OpManager with OpsGenie

Integrating OpsGenie with OpManager brings a powerful synergy to your IT operations and event management strategy. This enables advanced alerting capabilities, ensuring that critical issues are detected and communicated promptly. By combining these strengths, it helps organizations enhance operational efficiency, improve event resolution, and maintain high service reliability.

OpManager can be integrated with OpsGenie using the **custom integration** option.

**Steps to perform in OpsGenie**

1. [Activate Integration](https://www.manageengine.com/network-monitoring/help/configure-opm-opsgenie.html#act-int)

**Steps to perform in OpManager**

1. [To Add an Event](https://www.manageengine.com/network-monitoring/help/configure-opm-opsgenie.html#add-in)
2. [To Add Notes to an Event](https://www.manageengine.com/network-monitoring/help/configure-opm-opsgenie.html#notes)
3. [To close an Event](https://www.manageengine.com/network-monitoring/help/configure-opm-opsgenie.html#close-event)
4. [Associate a notification profile](https://www.manageengine.com/network-monitoring/help/configure-opm-opsgenie.html#notification-profile)

## Steps to perform in OpsGenie

### a. Activate Integration in OpsGenie

1. **Login to OpsGenie**  
   To activate integration in OpsGenie, [login](https://www.atlassian.com/software/opsgenie/migration) here.

   ![opsgenie-login](https://www.manageengine.com/network-monitoring/how-to/images/opm-opsgenie-1.png)

2. **Create a Team**  
   Navigate to **Teams > Add Team** to create a new team. Once the team is created, you will be redirected to the team’s page.

   ![opsgenie-team](https://www.manageengine.com/network-monitoring/how-to/images/opm-opsgenie-2.png)

3. **Add an Integration**  
   Click on **Integrations > Add Integration** to enable a new integration. A list of available integrations will be displayed.

   ![opsgenie-integration](https://www.manageengine.com/network-monitoring/how-to/images/opm-opsgenie-3.png)

4. **Select API Integration**  
   Choose the "API" integration to perform REST operations. Both free and paid options are available—select based on your requirements. Copy the **API key**.

   ![opsgenie-api](https://www.manageengine.com/network-monitoring/how-to/images/opm-opsgenie-4.png)

5. **Enable Access**  
   Verify if access is enabled. If not, click **Edit** and enable access. Once created, you will receive integration settings, including the API key and other configuration details.

   ![opsgenie-access](https://www.manageengine.com/network-monitoring/how-to/images/opm-opsgenie-5.png)

6. **Activate the Integration**  
   Click **Turn on Integration** to activate it.

   ![opsgenie-activation](https://www.manageengine.com/network-monitoring/how-to/images/opm-opsgenie-6.png)

7. Click **Save**.

## Steps to perform in OpManager

### a. Add an Event in OpManager

- In **OpManager**, navigate to **Settings > Integrations > Custom Integration**.
- Enter the **Integration Name** and add a **Decscription**.
- Set up integration parameters:
  - **Integration Type:** Event Management
  - **API Endpoint:** https://api.opsgenie.com/v2/alerts
  - **Method:** POST
  - **Headers:** Authorization: GenieKey eb2*****************************f56 {copied API Key from opsgenie}
  - **Payload Type:** JSON
  - **Data Type:** Raw
  - **Body Content:**

```json
{
  "message": "$message",
  "details": {
    "displayname": "$displayName",
    "Severity": "$stringseverity",
    "Category": "$category"
  }
}
```

![opsgenie-create-event](https://www.manageengine.com/network-monitoring/help/images/ops-genie-1.png)

- Click **"Test Action"** to check the configuration. Once successful, select **"Manage Events"** to fetch the event ID. You will get a `request_id`, which can be used to acknowledge and close the particular event on the OpsGenie side.

![opsgenie-manage-event](https://www.manageengine.com/network-monitoring/help/images/ops-genie-2.png)

### b. Add Notes to an Event in OpManager

- **API:** https://api.opsgenie.com/v2/alerts/$requestId/notes
- **Method:** POST
- **Headers:** Authorization:GenieKey eb2*****************************f56 {copied API Key from opsgenie}
- **Payload Type:** JSON
- **Data Type:** Raw
- **Body Content:**

```json
{
  "message": "$message",
  "details": {
    "displayname": "$displayName",
    "Severity": "$stringseverity",
    "Category": "$category"
  }
}
```

![opsgenie-update-event](https://www.manageengine.com/network-monitoring/help/images/ops-genie-3.png)

### c. Close an Event in OpManager

- **API:** https://api.opsgenie.com/v2/alerts/$requestId/close
- **Method:** POST
- **Headers:** Authorization:GenieKey eb2*****************************f56 {copied API Key from opsgenie}
- **Payload Type:** JSON
- **Data Type:** Raw
- **Body Content:**

```json
{
  "message": "$message",
  "details": {
    "displayname": "$displayName",
    "Severity": "$stringseverity",
    "Category": "$category"
  }
}
```

![opsgenie-close-event](https://www.manageengine.com/network-monitoring/help/images/ops-genie-4.png)

- Click **Save** to finalize the configuration.
- Click **Configure Now** under "Associate Notification Profile".

![associate-notification-profile-in-opmanager](https://www.manageengine.com/network-monitoring/help/images/opm-associate-notification-profile.png)

- Select **Custom_Integration** and choose the profile named "OpsGenie".
- Learn more about configuring [criteria](https://www.manageengine.com/network-monitoring/help/configuring-notifications.html#criteria-notifications), [devices](https://www.manageengine.com/network-monitoring/help/configuring-notifications.html#select-devices), and [time window](https://www.manageengine.com/network-monitoring/help/configuring-notifications.html#applying-time-window) in notification profiles [here](https://www.manageengine.com/network-monitoring/help/configuring-notifications.html).
- Click **Save**.

Refer to the steps below to **configure multiple notification profiles**.

### Associate a Notification Profile

Follow the steps below to configure the notification profile:

1. Go to **Settings** > **Notifications** > **Notification Profiles** > **Add**
2. Select **Custom_Integration** and choose the profile named "OpsGenie".

![opsmanager-opsgenie-integration](https://www.manageengine.com/network-monitoring/help/images/ops-genie-5.png)

3. Learn more about configuring [criteria](https://www.manageengine.com/network-monitoring/help/configuring-notifications.html#criteria-notifications), [devices](https://www.manageengine.com/network-monitoring/help/configuring-notifications.html#select-devices), and [time window](https://www.manageengine.com/network-monitoring/help/configuring-notifications.html#applying-time-window) in notification profiles [here](https://www.manageengine.com/network-monitoring/help/configuring-notifications.html?custom_integration_opsgenie).
4. Click **Save**.

Refer to the [OpsGenie Alert API documentation](https://docs.opsgenie.com/docs/alert-api) to check for Alerts API parameters.

### Verifying the Integration

Trigger a real-time alert in OpManager. Then, log in to your OpsGenie interface to verify the alert has been logged as an event.

[Know more about the integrations offered by OpManager](https://www.manageengine.com/network-monitoring/integration.html?custom_integration_opsgenie)

[Know more about dynamic variables used in request body](https://www.manageengine.com/network-monitoring/faq/what-are-dynamic-variables.html?custom_integration_opsgenie)