|docs
Start Trial

AI & Automation

Workflow Integrations

Connect Incident Workflows to external tools like AWS, GitHub, and Slack via API key or OAuth-based Workflow Integrations.

View as Markdown

Some Workflow Actions rely on a type of integration called Workflow Integrations to connect Incident Workflows to external tools. Workflow Integrations support authentication via API keys or OAuth, letting incident response teams and administrators connect PagerDuty to the tools they use during a response.

API Key vs. OAuth Authentication

Tools that use OAuth redirect you to the provider's own login or authorization page to complete the connection. Tools that use API keys or tokens require you to generate a credential in the external tool and enter it directly into PagerDuty.

Workflow Integrations are supported with the following tools:

Required Permissions

If you have one of the following base roles, you can add, update, and delete Workflow Integration connections:

  • Manager
  • Admin
  • Account Owner

Create a Workflow Integration

Workflow Integrations securely store connection credentials.

  1. In the PagerDuty web app, navigate to Integrations Workflow Integrations.
  2. Click Add Connection to the right of your preferred tool.
Add connection
Add connection
  1. Expand the section that corresponds to your preferred technology and enter the requested information:
  1. In the field Who can edit or select the connection, select All admins and global managers (default) or All admins, global managers team managers on specific teams. If you choose All admins, global managers team managers on specific teams, select one or more Teams from the Select teams dropdown.
Select Teams
Select teams dropdown

Permission Scope

This setting affects which users can edit the connection or select the connection when configuring actions in an Incident Workflow. This setting does not affect who can invoke an Incident Workflow; that setting is administered while creating or editing an Incident Workflow.

  1. Click Add.

Delete a Workflow Integration

  1. In the web app, navigate to Integrations Workflow Integrations.
  2. Click the Integration Name (for example, AWS, Azure Functions) that contains the connection you want to delete.
  3. To the right of the connection you want to delete, click Delete.
  4. In the confirmation modal, click Delete. This action cannot be undone.

Use a Workflow Integration in Incident Workflows

Creating a Workflow Integration allows you to use specific tool-specific Incident Workflow Actions. Read Incident Workflows for more information.