# PagerDuty (prebuilt connector)

## Description

**PagerDuty** is a SaaS incident response platform, delivering visibility and intelligence across the entire lifecycle of incidents.

## API documentation

API documentation for **PagerDuty** (used to build this connector) can be found via the link below:

{% embed url="<https://developer.pagerduty.com/docs/ZG9jOjQ2NDA2-introduction>" %}

## Authentication&#x20;

When adding connector instances for **PagerDuty**, the following authentication methods are supported:

* [Token authentication](#token-authentication)

### Token authentication

{% tabs %}
{% tab title="Required credentials" %}
When a user chooses to [add a connector instance](https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance) using **token** authentication, the credentials below are prompted:

<table><thead><tr><th width="193">Credential</th><th data-type="checkbox">Required?</th><th>Notes</th></tr></thead><tbody><tr><td><code>Token</code></td><td>true</td><td>This is the API key generated from the PagerDuty dashboard. </td></tr></tbody></table>
{% endtab %}

{% tab title="Obtaining credentials" %}
**Generating tokens**

**Step 1**\
Log into the PagerDuty dashboard.

**Step 2**\
Select *Integrations* from the top navigation bar, then select *API Access Keys*:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FwMLir9PrVnq6mr8itj07%2Fpager%201.png?alt=media&#x26;token=1c120c20-3f85-43f1-af9f-c00becd81cc6" alt=""><figcaption></figcaption></figure>

**Step 3**\
Click the *Create New API Key* button:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FE7hnf35GvKYZGBWnEzis%2Fpager%202.png?alt=media&#x26;token=b7d83c41-fa14-47f8-9c9f-ccc7be126637" alt=""><figcaption></figcaption></figure>

**Step 4**\
Enter a *Description* for this token and click the *Create Key* button:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F28MdoO0424scepnemrIq%2Fpager%203.png?alt=media&#x26;token=c74fbe39-c1da-4561-8ea9-438bc8e42aea" alt=""><figcaption></figcaption></figure></div>

**Step 5**\
Token information is displayed:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FfQyiyzQg5JmUH8jw8D7C%2Fpager%204a.png?alt=media&#x26;token=2866e912-7be4-4cd7-9bff-1d01ec9920e2" alt=""><figcaption></figcaption></figure></div>

**Step 6**\
Save this token to your password manager for use when adding Patchworks instances of the PagerDuty connector.
{% endtab %}
{% endtabs %}