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

# PagerDuty

> View active incidents, on-call schedules, and service health from PagerDuty in Pwnbook's Security Workbench.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/pwnbook/logos/pagerduty.svg" alt="PagerDuty" style={{ height: "32px", marginBottom: "16px" }} />

## Overview

The PagerDuty integration surfaces active incidents and on-call schedule data in Pwnbook so security teams can monitor operational incidents alongside vulnerability findings and security events — without switching tools.

## Prerequisites

* A PagerDuty account
* Admin or Account Owner access in PagerDuty to create API keys
* Admin or Owner access in Pwnbook

## Credentials required

| Field       | Description                                                               |
| ----------- | ------------------------------------------------------------------------- |
| **API Key** | A PagerDuty REST API key — either a General Access key or a Read-only key |

A read-only key is sufficient for pulling incident and schedule data into Pwnbook.

## Setup

<Steps>
  <Step title="Create a PagerDuty API key">
    1. In PagerDuty, go to **Integrations → API Access Keys**.
    2. Click **Create New API Key**.
    3. Give it a description like "Pwnbook".
    4. Select **Read-only API Key** (Pwnbook only needs read access).
    5. Copy the generated key.
  </Step>

  <Step title="Configure in Pwnbook">
    1. Go to **Organization Settings → Marketplace → PagerDuty**.
    2. Paste your **API Key**.
    3. Click **Save & Test** — Pwnbook verifies access by listing your PagerDuty services.
  </Step>
</Steps>

## What's available

| Feature               | Description                                                           |
| --------------------- | --------------------------------------------------------------------- |
| **Active incidents**  | Count of open and acknowledged incidents, broken out by urgency       |
| **Incident list**     | Filterable list of incidents with service, status, and triggered time |
| **On-call schedules** | Who is currently on call for each schedule                            |
| **Services**          | Health summary across your PagerDuty services                         |

## Workbench card

The PagerDuty workbench card on your Security Workbench shows:

* Count of triggered (unacknowledged) and acknowledged incidents
* Current on-call responder name for your primary schedule
* A **View all** link to the full incident list

## Incident urgency mapping

PagerDuty incidents have a `high` or `low` urgency. Pwnbook displays them as:

| PagerDuty urgency | Displayed as |
| ----------------- | ------------ |
| `high`            | Critical     |
| `low`             | Low          |

## Disconnecting

1. Go to **Organization Settings → Marketplace → PagerDuty**.
2. Click **Disconnect**.
3. Confirm.