PagerDuty Integration

Prerequisites

Step 1: Generate PagerDuty API Key

1. Log into PagerDuty and go to Integrations → API Access Keys
2. Click Create New API Key
3. Name it StackFlow Integration and select Read/Write
4. Copy the generated API key — it is shown only once

Step 2: Create a Service Integration

1. In PagerDuty, go to Services → Service Directory → [your service] → Integrations → Add Integration
2. Search for Events API v2 and add it
3. Copy the Integration Key (routing key) for this service
4. Repeat for each PagerDuty service you want to map to StackFlow assignment groups

Step 3: Configure Service Mapping

Map PagerDuty services to StackFlow assignment groups so incidents route correctly:

{
  "service_mapping": [
    {
      "pagerduty_service_id": "P1234AB",
      "pagerduty_service_name": "Production API",
      "stackflow_assignment_group": "Platform Engineering",
      "stackflow_category": "api",
      "integration_key": "abc123def456..."
    },
    {
      "pagerduty_service_id": "P5678CD",
      "pagerduty_service_name": "Database Service",
      "stackflow_assignment_group": "Database Reliability",
      "stackflow_category": "database",
      "integration_key": "xyz789..."
    }
  ]
}

Step 4: Connect in StackFlow

1. Navigate to Admin → Integration Hub → PagerDuty → Configure
2. Paste your PagerDuty API Key
3. Enter your PagerDuty subdomain (e.g., your-org from your-org.pagerduty.com)
4. Configure the service mapping table
5. Enable Bidirectional Sync and enter the StackFlow webhook URL as a PagerDuty webhook extension
6. Click Save & Test

Bidirectional Sync

With bidirectional sync enabled, incidents created in StackFlow automatically trigger PagerDuty alerts, and PagerDuty incidents create StackFlow records. State changes sync in both directions:

Escalation Policy Mapping

Map PagerDuty escalation policies to StackFlow SLA breach escalation rules. When a StackFlow SLA is breached at 100%, the integration can trigger the associated PagerDuty escalation policy.

{
  "escalation_mapping": [
    {
      "stackflow_sla_policy": "P1-Response-SLA",
      "pagerduty_escalation_policy_id": "PXXXXXX",
      "trigger_on": "sla_breach"
    }
  ]
}

Field Reference

Testing the Integration

1. In StackFlow, go to Admin → Integration Hub → PagerDuty → Test
2. Click Send Test Event — a test alert should appear in PagerDuty
3. Acknowledge the PagerDuty incident and verify the StackFlow incident state changes to in_progress
4. Resolve the PagerDuty incident and verify the StackFlow incident moves to resolved

Troubleshooting