> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/ai-sre/3.0/ai-sre-for-administrators/set-up-alert-management/alerts/integrations/monitoring/pagerduty.md).

# PagerDuty Integration

Configure PagerDuty integration to receive incident management alerts in Harness AI SRE.

### Overview <a href="#overview" id="overview"></a>

PagerDuty provides:

* **Incident management:** Two-way incident synchronization
* **PagerDuty alert routing:** Route based on service and priority
* **PagerDuty on-call schedules:** Sync schedule information
* **PagerDuty escalation policies:** Mirror escalation rules
* **Service dependencies:** Track service relationships

***

### Use this template <a href="#use-this-template" id="use-this-template"></a>

#### In Harness AI SRE <a href="#in-harness-ai-sre" id="in-harness-ai-sre"></a>

Create the webhook integration from the PagerDuty template:

1. Navigate to **Integrations** in the main menu
2. Click **New Integration**
3. Select **PagerDuty** from the template options
4. Enter a name and generate an ID
5. Copy the generated webhook URL

The template automatically configures field mapping to match PagerDuty incident fields to Harness alert properties.

#### In PagerDuty <a href="#in-pagerduty" id="in-pagerduty"></a>

Configure PagerDuty to send webhooks to your Harness webhook URL. Go to the [PagerDuty webhook setup guide](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/integration-guides/monitoring/pagerduty.md) to complete the step-by-step instructions.

***

### Example alert payload <a href="#example-alert-payload" id="example-alert-payload"></a>

```json
{
  "event": {
    "id": "01BKGDFB3DZXFJ9W6JQ5QPKM9I",
    "event_type": "incident.trigger",
    "resource_type": "incident",
    "occurred_at": "2025-03-16T15:00:00.000Z",
    "agent": {
      "id": "P123456",
      "type": "service"
    }
  },
  "incident": {
    "id": "PIJ90N7",
    "incident_number": 123,
    "title": "High CPU Usage",
    "description": "CPU usage above 90% for 5 minutes",
    "created_at": "2025-03-16T15:00:00.000Z",
    "status": "triggered",
    "urgency": "high",
    "priority": {
      "id": "P1",
      "name": "P1",
      "description": "Critical - Service Down"
    }
  }
}
```

***

### Configure PagerDuty to send webhooks <a href="#configure-pagerduty-to-send-webhooks" id="configure-pagerduty-to-send-webhooks"></a>

After creating a webhook from this template in Harness, configure PagerDuty to send incidents to your webhook URL.

Go to the [PagerDuty webhook setup guide](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/integration-guides/monitoring/pagerduty.md) to complete detailed step-by-step instructions, including:

* Set up V3 webhooks or webhook extensions
* Select event types to monitor
* Configure event filters
* Test the integration

***

### Next steps <a href="#next-steps" id="next-steps"></a>

* [Route alerts](/ai-sre/ai-sre-for-administrators/set-up-alert-management/alert-rules/overview.md): Route PagerDuty alerts to the right destinations.
* [Use CEL in webhooks](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/use-cel-webhooks.md): Add custom filtering logic.
* [Webhook templates overview](/ai-sre/ai-sre-for-administrators/set-up-alert-management/webhooks/templates/overview.md): View other templates.