> For the complete documentation index, see [llms.txt](https://docs.runway.team/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.runway.team/integrations/incident-management-and-scheduling/pagerduty.md).

# PagerDuty

<div align="left"><figure><img src="/files/0Bz3JQOAouUWQqnoFNbR" 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](/using-runway/app-settings/release-pilot-rotation.md#using-a-scheduling-integration-to-manage-the-release-pilot-rotation).
