> ## Documentation Index
> Fetch the complete documentation index at: https://docs.resolve.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# PagerDuty

This guide explains how to connect ResolveAI with PagerDuty.

**How does Resolve use the PagerDuty integration?** Resolve receives alert webhooks, which allow you to trigger investigations automatically when  alerts fire. Resolve can also scrape alerts directly from the PagerDuty API for use in investigations.

<Info>
  **Prerequisites:** You will need permissions to **create webhooks in PagerDuty,** and admin access to [the PagerDuty integrations page](https://app0.resolve.ai/integrations/pagerDuty/connect) in ResolveAI.
</Info>

## 1 . In ResolveAI, create a webhook

1. In the Resolve UI, open the [PagerDuty Integration](https://app0.resolve.ai/integrations/pagerDuty/connect)
2. Click **Add Connection**
3. Enter **Name**, ex. `PagerDuty`
4. Skip **Environments**
5. Click **Save**
6. In the Connections table, click the **Name** of the integration you just created, to re-open that integration instance
7. At the bottom of the page click **Edit**
8. Under **Webhooks** click the **+** plus button to add a new webhook
9. Give the webhook a **Name**, ex. `frontend latency`
10. Use the in-UI instructions to get the **Webhook URL** and **Custom Header**

## 2. In PagerDuty, create a webhook

1. In PagerDuty, open the service you want to connect.
2. Open **Integrations -> Add Webhook** and fill the following fields:
   1. **Webhook URL**: *from Resolve UI*
   2. **Event Subscriptions**
      1. `incident.triggered`
      2. `incident.resolved`
   3. **Custom Header**: *from Resolve UI*
3. Click **Add Webhook** and copy the **webhook secret**

## 3. In ResolveAI, enter the webhook secret

* In the Resolve UI, open [the PagerDuty integration page](https://app0.resolve.ai/integrations/pagerDuty/connect)
* Click **Edit** and open **Advanced Settings**
* Enter the **Webhook Secret**
* Click **Save**

## Optional: Enable Alert Scraping

In ResolveAI, enter your PagerDuty API token:

* In the Resolve UI, open [the PagerDuty integration page](https://app0.resolve.ai/integrations/pagerDuty/connect)
* Click **Edit** and open **Advanced Settings**
* Enter the **API Token**
* Click **Save**