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

# PagerDuty

> Incident management and on-call scheduling

## Overview

Connect PagerDuty to enable TierZero to receive incident events and participate in your incident response workflow. TierZero can automatically investigate incidents triggered through PagerDuty.

## Prerequisites

* Administrative access to your PagerDuty account
* Permission to configure webhook subscriptions

## Setup Instructions

### Step 1: Navigate to Integration Settings

1. Log into your TierZero dashboard
2. Go to **Settings → Integrations**
3. Click **Connect** next to PagerDuty

### Step 2: Configure PagerDuty Webhook

1. TierZero will display a webhook URL. Copy it
2. In PagerDuty, go to **Integrations → Generic Webhooks (v3)**
3. Click **New Webhook**
4. Paste the TierZero webhook URL as the endpoint
5. Select the events to forward:
   * `incident.triggered`
   * `incident.acknowledged`
   * `incident.resolved`
6. Optionally filter by service or team
7. Copy the webhook secret

### Step 3: Create a Webhook Subscription in TierZero

1. Back in TierZero, enter the webhook details:
   * **Name**: A descriptive name (e.g., "PagerDuty Production")
   * **Remote ID**: The webhook subscription ID from PagerDuty
   * **Secret**: The webhook signing secret

Configure webhook subscriptions from the TierZero dashboard to receive these events.

## What TierZero Accesses

* **Incident events**: Trigger, acknowledgment, and resolution events
* **Incident metadata**: Severity, service, escalation policy, assigned responders

## Using with Alert Agents

After creating a webhook subscription, connect it to an Alert Agent:

1. Create or edit an Alert Agent
2. Select **Webhook** as the alert source
3. Choose your PagerDuty webhook subscription
4. TierZero will automatically investigate incidents

## Using with Incident Agent

PagerDuty incidents can trigger the [Incident Agent](/features/incident-agent), which auto-joins the corresponding Slack channel and begins real-time investigation.

## Security

* PagerDuty webhook signatures are validated using HMAC-SHA256
* Secrets are encrypted at rest and never returned in API responses
* Revoke by deleting the webhook subscription in PagerDuty

## Troubleshooting

### Incidents Not Triggering

* Verify the webhook URL is correct in PagerDuty
* Check that the webhook secret matches
* Confirm the webhook is not filtered to exclude the triggering service
* Review PagerDuty's webhook delivery logs under **Integrations → Generic Webhooks**