Skip to main content

Connecting PagerDuty to Bicycle

Learn how to authorize PagerDuty with OAuth or an API key and connect your PagerDuty account to Bicycle.

Requirements​

To follow the steps in this guide, you'll need:

  • Permission to create connectors in Bicycle
  • A PagerDuty account
  • For OAuth: permission to authorize the Bicycle app in PagerDuty
  • For API key: permission to create a User API token in PagerDuty
Official PagerDuty documentation

Open Connectors and select PagerDuty

In Bicycle, go to Connectors. Find PagerDuty and click + Connect.

Choose OAuth

Enter a connection name that identifies the environment, such as PagerDuty Production. Select OAuth as the Connector method, then click Next.

Authorize in PagerDuty

After you click Next, Bicycle opens a popup to PagerDuty's authorization page. The main window shows Waiting for authorization... while you complete sign-in in the popup.

Sign in to PagerDuty and authorize the application.

The following scopes are requested automatically during OAuth:

  • openid — OpenID Connect authentication
  • read — General read access (required for MCP)
  • write — General write access
  • incidents.read — Read incidents
  • incidents.write — Manage incidents
  • services.read — Read services
  • teams.read — Read teams
  • users.read — Read users
  • oncalls.read — Read on-call schedules
  • schedules.read — Read schedules
  • escalation_policies.read — Read escalation policies

Confirm the connection

When authorization completes, the popup shows Connected Successfully! and closes automatically. Bicycle shows Connection successfully added! with the connection name, ID, and method (OAuth). Click Close to return to the Connectors page.

Connect with API key​

Use this path if your organization prefers token-based access.

In PagerDuty​

Create a User API token

  1. Log in to your PagerDuty account.
  2. Open My Profile > User Settings > API Access.
  3. Create a new User API token or copy an existing one.

Use a token with the permissions Bicycle needs in your organization.

In Bicycle​

Open Connectors and select PagerDuty

In Bicycle, go to Connectors. Find PagerDuty and click + Connect.

Choose API key

Enter a connection name that identifies the environment, such as PagerDuty Production. Select API key as the Connector method, then click Next.

Configure MCP

On the Configure MCP step, paste your PagerDuty User API token.

API TokenRequired

User API token from PagerDuty My Profile > User Settings > API Access

Test the connection

Click Test connection. When the test succeeds, you will see Connection verified successfully.

Save the connection

Click Save connection. When the connection is created successfully, you will see Connection successfully added! with the connection name, ID, and method (API key). Click Close to return to the Connectors page.

Troubleshooting​

If Test connection fails, check the following.

Error or symptomLikely causeFix
Authentication failedInvalid or expired OAuth session or API keyRe-authorize with OAuth or create a new User API token
Authorization failedToken lacks required PagerDuty permissionsAsk your PagerDuty administrator to grant the required access
OAuth redirect failsPagerDuty app authorization blockedConfirm your PagerDuty administrator approved the Bicycle app

References​