---
title: OpsGenie
description: Connect Honeybadger to OpsGenie to route critical errors and application issues through your incident management and on-call alerting system.
url: https://docs.honeybadger.io/guides/integrations/opsgenie/
---

Users with administrative privileges can find this integration below the list of personal alert integrations on the Alerts & Integrations tab of the Project Settings page.

## Setup

### 1. Select the OpsGenie integration

![opsgenie integration](https://docs.honeybadger.io/_astro/opsgenie.GE-hA0GM_k97Hy.webp) ![opsgenie form](https://docs.honeybadger.io/_astro/opsgenie_form.CC1z4Qpy_1P8Xak.webp)

### 2. Set the API key

Caution

Please note that the OpsGenie integration labeled “Honeybadger” is an older version that doesn’t currently support all the events we send.

You can generate a OpsGenie API key by creating an [API Integration](https://support.atlassian.com/opsgenie/docs/create-a-default-api-integration/) by logging in to OpsGenie then going to Settings - Integrations and selecting “API”.

![opsgenie integration select](https://docs.honeybadger.io/_astro/opsgenie-integration-select.CBEEvdhW_Z1oe6xL.webp)

### 3. Select region

We can send to both US and EU regions.

### 4. Select label (optional)

If you have multiple OpsGenie integrations, you can add a label to differentiate in the integration list view.

### 5. Save

That’s it! You can test the integration by clicking “Test”. Otherwise, just save it and you’re ready to go.

## Configuring OpsGenie alerts

OpsGenie provides the option to route the alerts based on the kind of event that is reported to OpsGenie, and elements from the event payloads can be used in the alert rules. For example, when a check-in fails to report on time, Honeybadger will send the “Check-In Missing” event to OpsGenie. You can use the **Details (key-value)** condition to match that event by specifying “Event” as the **Key** and “Check-In Missing” as the **Value**:

![opsgenie alert configuration screen](https://docs.honeybadger.io/_astro/opsgenie-alert-filters.JR_yFJt8_Z7iPjz.webp)

## Event Payloads

The following events are supported by the OpsGenie integration:

### `Assigned`

Sent when an error is assigned to a user.

**Additional Details keys:** `Error Details`, `Project`, `Environment`, `Assignee Name`, `Assignee Email`

### `Cert Will Expire`

Sent when an SSL certificate is about to expire.

**Additional Details keys:** `Project`, `Name`, `URL`

### `Check-In Missing`

Sent when an expected check-in is missing.

**Additional Details keys:** `Check-In Details`, `Project`, `Name`

### `Check-In Reporting`

Sent when a check-in reports successfully.

**Additional Details keys:** `Check-In Details`, `Project`, `Name`

### `Commented`

Sent when a comment is added to an error.

**Additional Details keys:** `Error Details`, `Project`, `Environment`, `Author`

### `Deployed`

Sent when a deployment is recorded.

**Additional Details keys:** `Project`, `Environment`, `Revision`, `Repository`

### `Down`

Sent when an uptime check fails.

**Additional Details keys:** `Outage Details`, `Project`, `Name`, `URL`

### `Occurred`

Sent when an error occurs.

**Additional Details keys:** `Error Details`, `Project`, `Environment`

### `Rate Exceeded`

Sent when error rate threshold is exceeded.

**Additional Details keys:** `Error Details`, `Project`, `Environment`

### `Resolved`

Sent when an error is marked as resolved.

**Additional Details keys:** `Error Details`, `Project`, `Environment`

### `Unresolved`

Sent when a resolved error occurs again.

**Additional Details keys:** `Error Details`, `Project`, `Environment`

### `Up`

Sent when an uptime check succeeds after being down.

**Additional Details keys:** `Outage Details`, `Project`, `Name`, `URL`

---

## Try Honeybadger for FREE

Intelligent logging, error tracking, and Just Enough APM™ in one dev-friendly platform. Find and fix problems before users notice.

[Start free trial](https://app.honeybadger.io/users/sign_up)

[See plans and pricing](https://www.honeybadger.io/plans/)