# PagerDuty Connector
PagerDuty (opens new window) is an incident response platform and on-call management service.
# API version
This connector uses the PagerDuty REST API (opens new window).
# How to connect to PagerDuty on Workato
Field | Description |
---|---|
Connection name | Give this connection a unique name that identifies which PagerDuty instance connected. |
API key | Go to Configuration -> API Access and get API Key. Learn how to create a PagerDuty API Key |
# How to create a PagerDuty API key
Create an API key (i.e. PagerDuty integration key) to connector to Workato. PagerDuty supports two types of API keys:
- General access API key: This API key has access to all objects in your PagerDuty instance.
- Personal API key: This API keys is restricted according to the user's permissions. This requires PagerDuty advanced permissions (opens new window).
Once you have decided which API key to use. Follow these instructions to create your PagerDuty API key.
Go to Apps & Add-Ons > API Access and click Create New API Key.
If you are creating a Personal API key, go to Profile > User settings.
Enter a Description that will help you identify the key later on (for example, "Workato integration key". Ensure that you do not select Read-only. This connector requires read and write permissions to function properly.
Provide the API key with write permissions
Once your key has been created, store it is a secure location. This API key will be used to authenticated with Workato.
# Permissions
Ensure that the API key provisioned contains write permission. When create the API access key, make sure that Read-only API key is left un-selected.
Required user permissions
You must have an Admin, Global Admin or Account Owner role within PagerDuty to access General Access REST API keys.
If you do not have this role, contact an Admin or Account Owner within your organization to create this API key.
# Read more
You can browse the following chapters.
- New incident
- New notification
- Add note to incident
- Get incident by id
- List log entries
- Search incident
- Send an event
- Update incident
# Get help with your PagerDuty integration
If you need help with this integration, please contact Workato Support (opens new window).
Last updated: 7/2/2021, 7:31:20 AM