PagerDuty

PagerDuty: Permissions and setup

Connect PagerDuty with Atomicwork to sync incidents, automate responses, and streamline IT operations.

The Atomicwork–PagerDuty integration brings powerful PagerDuty incident response capabilities directly to your Atomicwork platform.

This integration allows IT teams to create PagerDuty incidents from Atomicwork, access and sync PagerDuty incidents with Atomicwork incidents through workflow actions, and maintain a unified incident flow, by connecting PagerDuty’s real-time incident flow with Atomicwork's workflows.

Permissions

To set up the integration, you need:

1. An Atomicwork admin account
2. A PagerDuty admin account

You also must authorize the following OAuth scopes for a smooth Atomicwork-PagerDuty integration:

• services.read
• services.write
• incident_types.read
• incident_types.write
• incident_workflows.read
• incident_workflows.write
• incident_workflows:instances.write
• incidents.read
• incidents.write
• notifications.read
• users.read
• users.write
• users:contact_methods.read
• users:contact_methods.write
• users:sessions.read
• users:sessions.write

Setup

Connecting PagerDuty to Atomicwork is a straightforward process using the standard OAuth 2.0 workflow.

1. Navigate to the Atomicwork App Store through Settings > App Store > PagerDuty
2. Click Connect to initiate the setup.
3. Log in to your PagerDuty account if prompted and authorize the requested permissions.
4. Once connected, you can use PagerDuty actions within your Atomicwork workflows.

Supported actions

The integration supports the following actions that can be used within Atomicwork workflows to automate your incident response:

• Create Incident: Creates an incident synchronously in PagerDuty without requiring a corresponding event from a monitoring service.
• Create Incident Note: Adds a new note to a specified incident for better context and collaboration.
• Get Incident: Retrieves detailed information about a specific incident using the incident ID or number.
• Get Incident Alert: Returns information about a specific alert related to an incident.
• Get User: Fetches information about a specified PagerDuty user (excluding the main account owner).
• List Incident Alerts: Returns a list of alerts associated with a specific incident.
• List Incident Notes: Retrieves all notes attached to a specific incident.
• List Incidents: Returns a list of incidents, with options to filter by status, urgency, and date range.
• Get Users: Retrieves a list of users in the PagerDuty account. This action is also used to validate the integration connection.
• Update Incident: Allows you to acknowledge, resolve, escalate, or reassign one or more incidents.
• Call API: A generic action that enables you to make custom API calls to any PagerDuty endpoint for advanced requirements.