Explore documentation
  1. Welcome to Uptime 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Connecting external calendars
    4. Advanced guide
  4. Incidents
    1. Get started
    2. Post mortems
    3. Metadata & Catalog
    4. Screening alerts
    5. 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. Uptime API
    1. Getting an API token
    2. Monitors
    3. Heartbeats
    4. On-call & incidents
    5. Status pages
    6. Metadata
    7. Integrations
      1. New Relic
      2. Datadog
      3. AWS CloudWatch
      4. Microsoft Azure
      5. Google Monitoring
      6. Grafana
      7. Elastic
      8. Prometheus
      9. Email
      10. Incoming webhooks
      11. Atlassian Jira
      12. Slack
      13. Outgoing webhooks
      14. Splunk On-Call
      15. 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
      16. Catalog
    8. Team members
    9. Organization roles
    10. Usage
    11. Reporting

Create PagerDuty integration

Returns either a newly created PagerDuty integration, or validation errors.

POST https://uptime.betterstack.com/api/v2/pager-duty-webhooks

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
string

application/json

Body parameters

team_name
string

Required if using global API token to specify the team which should own the resource

name
string

The name of the PagerDuty integration that you can see in the dashboard.

key
required string

The PagerDuty routing key.

severity
required string

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

notify_alongside_primary_responder
boolean

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

201

Returns the newly created 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"
    }
  }
}

Example cURL

Example
curl -X "POST" "https://uptime.betterstack.com/api/v2/pager-duty-webhooks/" \
     -H "Authorization: Bearer $TOKEN" \
     -H 'Content-Type: application/json; charset=utf-8' \
     -d $'{
  "name": "PagerDuty alerts",
  "key": "[key]",
  "severity": "critical"
}'


Previous article

Get PagerDuty integration

Next article

Update PagerDuty integration