# PagerDuty

## How it works

Acho allows you to connect to your PagerDuty account and retrieve incidents data via API. You can combine PagerDuty with other data sources and turn it into desired data application, such as dashboards or searchable databases.

## Requirements

The PagerDuty integration requires an admin role in order to authorize the account. If you are not an admin, please reach out to an admin or account owner within your organization to configure the integration for you.

## Support

If you need any help getting the PagerDuty integration up and running, please do not hesitate to reach out to us via email at <contact@acho.io>.

## Integration Walkthrough

### In PagerDuty

There are two types of API Keys in PagerDuty. You can use either of them to set up the connection.

* [General Access REST API Key](#general-access-rest-api-key)
* [User Token REST API Key](#generate-a-user-token-rest-api-key)

#### General Access REST API Key

1\. Go to your PagerDuty account and navigate to **Integrations** **> Developer Tools > API Access Keys**.

![](https://3574406564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB_fx7PCUqvFEdrucJC%2Fuploads%2FITTSYuicVQOo1C2U2GfX%2Fimage.png?alt=media\&token=23328a7a-b069-4a9d-8e37-8a8a98d1505c)

2\. Click **Create New API Key**. Check **Read-only API Key.**

![](https://3574406564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB_fx7PCUqvFEdrucJC%2Fuploads%2FPweaHoZRHEJiPXde6pRb%2Fimage.png?alt=media\&token=32d7ac3d-456a-4f1d-ad54-b807e1666f99)

3\. Copy the API Key.

#### **User Token REST API Key**

1\. Go to your PagerDuty account and navigate to **User Icon** > **My Profile**

![](https://3574406564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB_fx7PCUqvFEdrucJC%2Fuploads%2Fx4sAT0JEV5oosTIfRATt%2Fimage.png?alt=media\&token=1215a771-279c-4ffd-8c18-4b6daceeae39)

2\. Navigate to  **User Settings.** In the section **API Access**, click **Create API User Token**.

![](https://3574406564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB_fx7PCUqvFEdrucJC%2Fuploads%2FDeUevKe6udLS5Is1cEr3%2Fimage.png?alt=media\&token=88957354-113c-4972-acb6-68b5412a1cc0)

3\. Write descriptions and click **Create Token**.&#x20;

![](https://3574406564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB_fx7PCUqvFEdrucJC%2Fuploads%2F1gScozpDHFNs5vQFX5V7%2Fimage.png?alt=media\&token=68a23ede-2909-4f73-98db-3e2fab4c5345)

4\. Copy your **API User Token**.

### In Acho

1\. Go to the **Resources** page and click the <img src="https://3574406564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB_fx7PCUqvFEdrucJC%2Fuploads%2Fct5RJC2cjHhrvymOWWGx%2Fimage.png?alt=media&#x26;token=b4ff0c44-5510-49d1-97dd-a155af254113" alt="" data-size="line">  button.&#x20;

2\. Select **PagerDuty**.

3\. Enter your account credentials and click **Connect**.&#x20;

* **`Cutoff Days`**
* **`Severity category`**&#x20;
* **`Incident Log`**&#x20;
* **`Page Size`**&#x20;
* **`PagerDuty API key`**: Use either [General Access REST API Key](#general-access-rest-api-key) or [User Token REST API Key](#generate-a-user-token-rest-api-key).

4\. Choose tables to import and click **Finish Setup**.&#x20;

5\. You will see a  <img src="https://3574406564-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_fx7PCUqvFEdrucJC%2F-MgBh5PshcmRFk38itib%2F-MgBo4LSmdK4OS-NqLZy%2Fsyncing.png?alt=media&#x26;token=452494f9-e4be-48fa-9644-bee7d969c46c" alt="" data-size="line"> icon next to your resource. It may take a few minutes to several hours depending on the data size and the number of your tables. Once your data is ready, you will receive a notification email.&#x20;

## Supported tables <a href="#output-schema" id="output-schema"></a>

* [Incidents](https://developer.pagerduty.com/api-reference/b3A6Mjc0ODEzOA-list-incidents) (Incremental)
* [Incident Log Entries](https://developer.pagerduty.com/api-reference/b3A6Mjc0ODE1NA-list-log-entries) (Incremental)
* [Priorities](https://developer.pagerduty.com/api-reference/b3A6Mjc0ODE2NA-list-priorities)
* [Users](https://developer.pagerduty.com/api-reference/b3A6Mjc0ODIzMw-list-users)