> For the complete documentation index, see [llms.txt](https://doc.wearepatchworks.com/product-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/patchworks-connectors/pagerduty-prebuilt-connector.md).

# 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

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](/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance.md) 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="/files/28PuAHm3Zfllf6XIxv0k" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/cU4Q9sgHZKMFcQPwljCJ" alt=""><figcaption></figcaption></figure>

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

<div align="left"><figure><img src="/files/QgMUckChTOgmiV5Lj9Pj" alt=""><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="/files/G8IKlOWODEuxrDfSN15r" 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 %}