# Opsgenie

## Set up

### Navigate to the Integration settings view

1. Select an app in the top left corner from the Switcher
2. Navigate to **App Settings** by clicking the gear icon (⚙️) at the top of the Timeline sidebar
3. Click on **Integrations** in the sidebar

### **Connect Opsgenie**

1. Find the **Opsgenie** integration module under the **Scheduling** section.
2. Click the **Connect** button.
3. Enter a Opsgenie **API Key**

{% hint style="info" %}
You can access or create an API key by visiting **Settings > App settings > API Key Management** in Opsgenie. Visit Opsgenie's [documentation](https://support.atlassian.com/opsgenie/docs/api-key-management/) for more info.
{% endhint %}

{% hint style="warning" %}
Your Opsgenie API key must have the following access rights in order to work properly with Runway:

* Read
* Create/Update
* Configuration Access
  {% endhint %}

### Configure the Opsgenie integration

1. Choose a **Schedule** and **Rotation** from the dropdown that will be used to assign release pilots to releases in Runway.

Release pilots will first be assigned to releases in Runway by matching up *target kickoff dates* to shifts in the configured Schedule and Rotation in Opsgenie. The user that's scheduled to be on-call on the target kickoff date of a given release will be assigned as release pilot when the release is created.

{% hint style="warning" %}
You will not be able to re-assign or override release pilots in Runway if a Scheduling integration is connected. You must manage release pilots and overrides from Opsgenie directly.
{% endhint %}

For more details on how the Scheduling integration affects the release pilot rotation in Runway, visit the [Release pilot rotation docs](https://docs.runway.team/using-runway/app-settings/release-pilot-rotation#using-a-scheduling-integration-to-manage-the-release-pilot-rotation).