Skip to main content

PagerDuty

Prefer guided AI setup?

Instead of following these steps manually, you can use the AI Credential Assistant — describe what you want to connect and the AI will walk you through the setup step by step, tailored to your account.

Overview​

Connect your PagerDuty account to Nirvai to automate incident management, on-call schedules, and alerting workflows.

Supported Authentication Methods​

  • API Key - REST API Token for full API access

Prerequisites​

  • A PagerDuty account
  • Admin or Account Owner role (to create API keys)

Setup Instructions​

API Key​

  1. Log in to your PagerDuty account
  2. Navigate to Integrations > Developer Tools > API Access Keys
    • Or go to: Settings (gear icon) > API Access
  3. Click Create New API Key
  4. Enter a description (e.g., "Nirvai Integration")
  5. Select key type:
    • Read-only: For monitoring only
    • Full Access: For creating/updating incidents
  6. Click Create Key
  7. Copy the API Key immediately (it won't be shown again)
  8. Paste the key in Nirvai

Alternative: User Token​

You can also use a User API Token:

  1. Click your avatar > My Profile
  2. Go to User Settings tab
  3. Scroll to API Access
  4. Click Create API User Token
  5. Copy and use the token

Key Types​

Key TypeUse CasePermissions
Account API KeyOrganization-wide accessRead-only or Full
User TokenUser-specific accessBased on user role

Available Operations​

With PagerDuty credentials, you can:

  • Create and manage incidents
  • Acknowledge and resolve alerts
  • Access on-call schedules
  • Manage escalation policies
  • View service status
  • Access users and teams
  • Manage maintenance windows

Troubleshooting​

Common Issues​

  • 401 Unauthorized: API key is invalid or revoked. Generate a new key.
  • 403 Forbidden: Key lacks permissions for the operation.
  • 404 Not Found: Resource doesn't exist or key can't access it.
  • Rate Limiting: PagerDuty limits API requests. Implement backoff.

Key Management​

  • API keys don't expire automatically
  • Revoke keys immediately if compromised
  • Use descriptive names to track key usage
  • Consider separate keys for different integrations

Finding Resource IDs​

PagerDuty uses alphanumeric IDs (e.g., PXXXXXX):

  • Service ID: In service URL or settings
  • User ID: In user profile URL
  • Incident ID: In incident URL

Webhook Alternative​

For real-time notifications, consider using PagerDuty webhooks:

  1. Go to Service > Integrations
  2. Add a Generic Webhook
  3. Configure the endpoint URL

Adapted from n8n documentation for Nirvai platform

Next Steps​

Got your credential? Connect it to an agent

Use the AI Tool Creator to turn this credential into agent-callable tools. Describe what your agent should be able to do and the AI investigates the API, configures the endpoints, and gives you a reviewable toolkit before saving anything.