Skip to main content

​
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
See Webhook Subscriptions for more details.

​
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, 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