Explore documentation
  1. Welcome to Incidents 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Tag on-call in Slack
    4. Mobile apps ↗
    5. Connecting external calendars
    6. Advanced guide
  4. Incident management
    1. Get started
    2. AI SRE investigations
    3. Post mortems
    4. Metadata & Catalog
    5. Screening alerts
    6. Reporting ↗
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Incidents API
    1. Getting an API token
    2. Pagination
    3. Monitors
    4. Heartbeats
    5. On-call & incidents
    6. Status pages
    7. Metadata
    8. Integrations
      1. New Relic
      2. Datadog
      3. AWS CloudWatch
      4. Amazon SNS
      5. Microsoft Azure
      6. Google Monitoring
      7. Grafana
      8. Elastic
      9. Prometheus
      10. E-mail
      11. Incoming webhooks
      12. Atlassian Jira
      13. Slack
      14. Outgoing webhooks
      15. Outgoing e‑mails
      16. Splunk On-Call
      17. PagerDuty
        1. List PagerDuty integrations GET
        2. Get PagerDuty integration GET
        3. Create PagerDuty integration POST
        4. Update PagerDuty integration PATCH
        5. Remove PagerDuty integration DELETE
      18. Catalog
    9. Team members
    10. Organization roles
    11. Usage
    12. Reporting

Get PagerDuty integration

Returns a single PagerDuty integration by ID.

GET https://incidents.betterstack.com/api/v2/pager-duty-webhooks/{pager_duty_webhook_id}

URL parameters

pager_duty_webhook_id
required string

The ID of the PagerDuty integration you want to get.

Headers

Authorization
required string

Bearer $TOKEN

200

Returns a single PagerDuty integration

Response body

{
  "data": {
    "id": "17",
    "type": "pager_duty_webhook",
    "attributes": {
      "name": "PagerDuty alerts",
      "key": "[key]",
      "severity": "critical",
      "notify_alongside_primary_responder": true,
      "team_name": "My team"
    }
  }
}

Response attributes

id
string

The ID of the PagerDuty integration.

type
string

Always pager_duty_webhook.

attributes.name
string

The name of the PagerDuty integration shown in the dashboard.

attributes.key
string

The PagerDuty routing key that events are sent with.

attributes.severity
string

The severity of PagerDuty alerts created for new incidents: info, warning, error, or critical.

attributes.notify_alongside_primary_responder
boolean

Whether to notify this integration alongside the primary responder when no escalation policy is configured.

attributes.team_name
string

The team this integration belongs to.

Example cURL

Example
curl --request GET \
  --url https://incidents.betterstack.com/api/v2/pager-duty-webhooks/17 \
  --header "Authorization: Bearer $TOKEN"


Previous article

List PagerDuty integrations

Next article

Create PagerDuty integration