Skip to main content

​
Integration Walkthrough

​
In Ravenna

The Ravenna PagerDuty integration uses OAuth 2.0 authentication, which means you do not need to create a service or copy integration keys in PagerDuty. Instead, you will authorize Ravenna to access your PagerDuty account directly.

​
Step 1: Navigate to Integrations

  1. Log in to your Ravenna account.
  2. Click on your profile icon in the top right corner.
  3. Select Settings from the dropdown menu.
  4. In the left sidebar, click Integrations.
  5. Scroll down to the Incident Management section.
  6. Locate the PagerDuty integration card.

​
Step 2: Connect to PagerDuty

  1. Click the Connect button on the PagerDuty integration card.
  2. A dialog will appear. Click Connect with PagerDuty to begin the OAuth authorization flow.
  3. You will be redirected to PagerDuty’s authorization page.

​
In PagerDuty

​
Step 3: Authorize Ravenna

  1. On the PagerDuty authorization page, review the permissions that Ravenna is requesting:
    • Read access to schedules
    • Read access to on-call data
    • Read access to users
  2. Ensure you are authorizing access for the correct PagerDuty account (check the account name at the top of the page).
  3. Click Allow to grant Ravenna access to your PagerDuty account.
  4. You will be automatically redirected back to Ravenna.

​
In Ravenna

​
Step 4: Confirm Connection

  1. Once redirected back to Ravenna, you will see a success message indicating the integration is connected.
  2. The PagerDuty integration card will now display a Connected status with a green indicator.
  3. Your PagerDuty schedules are now available for use in Ravenna workflows.

​
Step 5: Use in Workflows

  1. Navigate to Workflows in the left sidebar.
  2. Create a new workflow or edit an existing one.
  3. Add an action and select PagerDuty from the list of integrations.
  4. Choose Validate On-Call Membership as the action type.
  5. Select a Schedule from the dropdown menu (this will display all schedules from your PagerDuty account).
  6. Configure the workflow to take action based on whether the user is on-call (e.g., route ticket, send notification, escalate).
  7. Click Save to save your workflow.
Your workflow will now validate on-call status in real-time each time it runs, ensuring tickets are routed to the appropriate on-call engineer.

​
Troubleshooting

Cause: Insufficient permissions or browser issuesSolution:
  • Ensure you have admin access to your PagerDuty account
  • Try using a different browser or clearing your browser cache
  • Disable any browser extensions that might block OAuth redirects
  • Verify your PagerDuty account is active
Cause: Integration not properly connected or no schedules exist in PagerDutySolution:
  • Verify the integration shows as Connected in Settings > Integrations
  • Check that schedules exist in your PagerDuty account by navigating to People > On-Call Schedules in PagerDuty
  • Try disconnecting and reconnecting the integration
  • Refresh the Ravenna page after reconnecting
Cause: User email mismatch or schedule configuration issueSolution:
  • Ensure user emails in Ravenna exactly match user emails in PagerDuty (comparison is case-insensitive)
  • Verify the correct schedule is selected in your workflow configuration
  • Check the schedule configuration in PagerDuty to ensure users are properly assigned to on-call shifts
  • Confirm the schedule is active and has current on-call assignments

​
How to Uninstall

If you need to disconnect the PagerDuty integration from Ravenna:
  1. Navigate to Settings by clicking your profile icon in the top right corner.
  2. Click Integrations in the left sidebar.
  3. Scroll down to the Incident Management section.
  4. Locate the PagerDuty integration card.
  5. Click the Disconnect button next to the PagerDuty integration.
  6. A confirmation dialog will appear. Click Confirm to proceed with disconnection.
  7. The integration will be removed and the card will display a Connect button again.
Important: Disconnecting the PagerDuty integration will immediately stop all workflows that use PagerDuty on-call validation actions. Before disconnecting, ensure you have updated or disabled any workflows that depend on this integration to avoid workflow errors.
To revoke Ravenna’s access from the PagerDuty side:
  1. Log in to PagerDuty.
  2. Navigate to your User Profile by clicking your profile icon.
  3. Select My Profile from the dropdown.
  4. Click the User Settings tab.
  5. Scroll down to the Authorized Applications section.
  6. Locate Ravenna in the list of authorized applications.
  7. Click Revoke Access next to Ravenna.
  8. Confirm the revocation when prompted.