# PagerDuty

<div align="left"><figure><img src="https://727226624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjFmyReUsbJqDjHEAlW%2Fuploads%2FY2YTgwpnSl76TjOoU4W7%2Fpagerduty.png?alt=media&#x26;token=286b0827-f7e0-4d6c-8cdc-8ce083c4157a" alt=""><figcaption></figcaption></figure></div>

## 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 PagerDuty**

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

{% hint style="info" %}
You can access or create an API Access Key by visiting **Integrations > Developer Tools > API Access Keys > Create New API Key** in PagerDuty. Visit PagerDuty's [documentation](https://support.pagerduty.com/docs/api-access-keys#generate-a-general-access-rest-api-key) for more info.

*(Note that some teams report that their API keys need to be configured elsewhere in PagerDuty, by clicking on the **user avatar > My Profile > User Settings > Create API User Token**.**)***
{% endhint %}

### Configure the PagerDuty integration

1. Choose a Schedule 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 in PagerDuty. 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 PagerDuty 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).