> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# PagerDuty Connector

## Intro

PagerDuty is an operations performance platform designed to make businesses more reliable by eliminating the chaos across the entire operations lifecycle. Use Domo's PagerDuty connector to get reports about schedule management, alerting, and incident tracking. To learn more about the PagerDuty API, visit their website ([https://developer.pagerduty.com/documentation/rest](https://developer.pagerduty.com/documentation/rest)).

The PagerDuty connector is a "Cloud App" connector, meaning it retrieves data stored in the cloud. In the Data Center, you can access the connector page for this and other Cloud App connectors by clicking **Cloud App** in the toolbar at the top of the window.

This is the simplified version of this connector, which allows you to simply pull data for a previous month instead of specifying a date range. There is also an advanced version of the connector, which provides options for setting up a date range. For more information, see [PagerDuty Advanced Connector](/s/article/360042928954 "PagerDuty Advanced Connector").

You connect to your PagerDuty account in the Data Center. This topic discusses the fields and menus that are specific to the PagerDuty connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

## Prerequisites

To connect to your PagerDuty account and create a DataSet, you must have the following:

* The API key for your PagerDuty account. For information about generating a PagerDuty API key, see [https://support.pagerduty.com/hc/en-us/articles/202829310-Generating-an-API-Key](https://support.pagerduty.com/hc/en-us/articles/202829310-Generating-an-API-Key).
* The domain for your PagerDuty URL. For example, if your PagerDuty URL was [domo.pagerduty.com](http://domo.pagerduty.com/), you would enter `domo` as the domain.

## Connecting to Your PagerDuty Account

This section enumerates the options in the **Credentials** and **Details** panes in the PagerDuty Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

### Credentials Pane

This pane contains fields for entering credentials to connect to your PagerDuty account. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Field </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> API Key </p></td><td colspan="1" rowspan="1"><p> Enter the API Key for your PagerDuty account. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Domain </p></td><td colspan="1" rowspan="1"><p> Enter the domain for your PagerDuty URL. </p></td></tr></tbody></table>

For information about obtaining these credentials, see "Prerequisites," above.

Once you have entered valid PagerDuty credentials, you can use the same account any time you go to create a new PagerDuty DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](/s/article/360042926054 "Managing User Accounts for Connectors").

### Details Pane

This pane contains a primary menu from which you can select a report, along with various other fields and menus that may or may not appear depending on your selected report.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select a PagerDuty report. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><p> Alerts </p></td><td colspan="1" rowspan="1"><p> Retrieves existing alerts for a given time range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Alerts Rollup </p></td><td colspan="1" rowspan="1"><p> Retrieves existing alerts by day, week, or month for a given period of time. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Escalation Policies </p></td><td colspan="1" rowspan="1"><p> Retrieves all existing escalation policies. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Escalation Policies On Call </p></td><td colspan="1" rowspan="1"><p> Retrieves all existing escalation policies with currently on-call users. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Escalation Rules </p></td><td colspan="1" rowspan="1"><p> Retrieves rules for a specified escalation policy. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Incident Notes </p></td><td colspan="1" rowspan="1"><p> Retrieves existing notes for a specified incident. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Incidents </p></td><td colspan="1" rowspan="1"><p> Retrieves existing incidents. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Incidents Count </p></td><td colspan="1" rowspan="1"><p> Retrieves the count of the number of incidents matching the specified criteria. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Incidents Rollup </p></td><td colspan="1" rowspan="1"><p> Retrieves existing incidents by day, week, or month for a given period of time. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Log Entries </p></td><td colspan="1" rowspan="1"><p> Retrieves all incident log entries across the entire account. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Maintenance Windows </p></td><td colspan="1" rowspan="1"><p> Retrieves existing maintenance windows. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Schedule Overrides </p></td><td colspan="1" rowspan="1"><p> Retrieves overrides for a given time range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Schedules </p></td><td colspan="1" rowspan="1"><p> Retrieves existing on-call schedules. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Services </p></td><td colspan="1" rowspan="1"><p> Retrieves existing services. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Users </p></td><td colspan="1" rowspan="1"><p> Retrieves existing users. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Users on Call </p></td><td colspan="1" rowspan="1"><p> Retrieves existing on-call users. </p></td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Duration </p></td><td colspan="1" rowspan="1"><p> Select whether the data in this report is for a single specified date or for the past month. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Report Date </p></td><td colspan="1" rowspan="1"><p> Specify whether the data is for a specific or relative date. Choose <b> Relative </b> if you always want the report to retrieve data for a given number of days back (which you specify in <b> Date Offset </b> ) from the current date. For example, if you enter <span class="mt-font-courier-new"> 5 </span> for <b> Date Offset </b> and set the DataSet to update daily, each new day the report will update to show information for the date 5 days in the past. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific Date </p></td><td colspan="1" rowspan="1"><p> Select the date you want to retrieve information for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Date Offset </p></td><td colspan="1" rowspan="1"><p> Enter the number of days back from the current date that will be presented in the report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Date Granularity </p></td><td colspan="1" rowspan="1"><p> Select whether you want report data to be shown by day, week, or month. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Policy Name </p></td><td colspan="1" rowspan="1"><p> Enter the name of the policy you want to retrieve information for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Policy ID </p></td><td colspan="1" rowspan="1"><p> Enter ID of the policy you want to retrieve information for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Incident ID </p></td><td colspan="1" rowspan="1"><p> Enter the ID of the incident you want to retrieve information for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> User ID(s) </p></td><td colspan="1" rowspan="1"><p> Enter the ID(s) of the user(s) you want to retrieve information for. Separate multiple IDs with commas. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Description </p></td><td colspan="1" rowspan="1"><p> Enter description text to filter the data in your report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Schedule ID </p></td><td colspan="1" rowspan="1"><p> Enter the ID of the schedule you want to retrieve information for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Schedule Name </p></td><td colspan="1" rowspan="1"><p> Enter the name of the schedule you want to retrieve information for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Username/Email Address </p></td><td colspan="1" rowspan="1"><p> Enter a username or email address to filter the data in your report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Rollup </p></td><td colspan="1" rowspan="1"><p> Select the desired grain for your report data--either daily, weekly, or monthly. </p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274).
