​
PagerDuty Permissions

PagerDuty scopes are tied to the integrating user’s permissions. The authenticated user will only be able to read and write to objects that they have access to. As part of the installation, Rootly will auto create a service account user in PagerDuty.
Document Image

​
Installing PagerDuty on Rootly

Locate PagerDuty on the Integrations catalog and select Setup.
Document Image
You’ll be prompted to sign in or create a new PagerDuty account.
Document Image
After signing in, you’ll be prompted to grant Rootly permission to integrate with your PagerDuty account.
Document Image
Once confirmed, the installation is complete!
Document Image

​
Setting Up PagerDuty Webhook

​
Via PagerDuty Web UI

We will attempt to create this for you automatically if the authenticated user account has enough privileges to create webhooks. If not you can still create the webhook manually in PagerDuty.
Log into your PagerDuty account and navigate to Integrations > Generic Webhooks.
Document Image
Select + New Webhook to open up the creation form.
Document Image
Enter the following information into the New Webhook form. Webhook URL: https://webhooks.rootly.com/webhooks/incoming/pagerduty_webhooks Scope Type: You can select from any of the following 3 options:
  • Service - Selecting this option will result in only events relating the selected service to be sent to Rootly.
  • Team - Selecting this option will result in only events relating to the selected team to be sent to Rootly.
  • Account - Selecting this option will result in events across the entire PagerDuty account to be sent to Rootly.
Description: Give your webhook a description. This field is optional. Event Subscription: Select the events you’d like PagerDuty to send to Rootly. We recommend you select all available options. Custom Header Name: secret Custom Header Value: <secret>
You can find the Webhook URL and header Secret by navigating to your Rootly Integrations > PagerDuty (setup) screen.
Document Image
The Webhook URL is universal across all Rootly accounts. The Secret is unique to each Rootly account.
Document Image
Once the form is completed, select Add Webhook. You’ll be prompted with a confirmation message containing a PagerDuty-generated webhook secret. You will not need this value for your Rootly integration. Simply click OK to complete setup.
Document Image

​
Via PagerDuty API

PagerDuty webhooks can also be set via API (https://developer.pagerduty.com/api-reference/ec247c8767c6d-create-a-webhook-subscription). URL: https://rootly.com/webhooks/incoming/pagerduty_webhooks Header: secret: <TOKEN> You can find the header secret token by navigating to your Rootly Integrations > PagerDuty (setup) screen. Pass the following events in the request and you’re all set! 
incident.acknowledged
incident.annotated
incident.delegated
incident.escalated
incident.priority_updated
incident.reassigned
incident.reopened
incident.resolved
incident.responder.added
incident.responder.replied
incident.status_update_published
incident.triggered
incident.unacknowledged
service.created
service.deleted
service.updated

​
Support

If you need help or more information about this integration, please contact support@rootly.com or start a chat by navigating to Help > Chat with Us.