Integrate PagerDuty with Round Robin

Connecting PagerDuty lets Round Robin read your PagerDuty schedules, so rotations can follow them automatically. Once connected, you can bind individual rotations to a PagerDuty schedule — see PagerDuty-based rotations.

You can connect in two ways:

Method	Pros	Trade-offs
API key	Simpler and faster to set up; a read-only key is enough	You manage a static credential
OAuth 2.0	Short-lived tokens, refreshed automatically	Requires creating an OAuth app in PagerDuty; the connection acts as the PagerDuty user who authorizes it, so that user must be able to see all the schedules and users you want to use

Note

Integrations are available on paid plans, and the connection is managed per Slack workspace.

Where to connect

Everything happens in the Round Robin dashboard: open Settings → Integrations to find the PagerDuty card alongside the other providers.

Connect with an API key

1. In the dashboard, go to Settings → Integrations and click Connect on the PagerDuty card.

2. In PagerDuty, create an API key from the Integrations menu. A read-only key is sufficient — Round Robin only reads schedules and users.

   

3. Back in the connect dialog, paste the API key and click Connect with API Key.

The PagerDuty card now shows the connection as active, with the last digits of your key. Use Edit API Key on the same card whenever you need to rotate the key.

Connect with OAuth 2.0

With OAuth, you first register an app in PagerDuty, then hand its credentials to Round Robin, which redirects you to PagerDuty to authorize the connection.

1. In PagerDuty, open the Integrations menu and choose App Registration.

   

2. Create a new app and enable OAuth 2.0 functionality.

   

3. Choose Scoped OAuth and add this redirect URL:

   https://api.roundrobinbot.eu/api/integrations/pagerduty/login/callback

   

4. Grant read access to Schedules, Teams, and Users. Round Robin requests the openid, schedules.read, teams.read, and users.read scopes.

   

   The final configuration should look like this:

   

5. Click Register App. PagerDuty shows a Client ID and a Client Secret — copy both.

   

6. Open the Round Robin dashboard, go to Settings → Integrations, and click Connect on the PagerDuty card.

7. Enter the Client ID and Client Secret in the OAuth section of the dialog and click Connect with OAuth.

8. You are redirected to PagerDuty to authorize the connection. When you approve, PagerDuty sends you back to the Round Robin dashboard.

Tip

Because the OAuth connection acts as the user who authorizes it, sign in with a PagerDuty account that can see every schedule you plan to use — an admin account is the safe choice.

If the connection ever needs to be re-authorized, use Refresh Connection on the PagerDuty card to run the login flow again.

Disconnect

On Settings → Integrations, click Disconnect on the PagerDuty card and confirm.

Caution

Disconnecting removes the PagerDuty binding from every rotation that uses it. Those rotations revert to Manual mode, so on-duty changes stop following the PagerDuty schedule until you reconnect and bind them again.