# PagerDuty — Pipedream Connect

> Real-Time Operations and Incident Response

- API slug: `pagerduty` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Developer Tools
- Website: https://www.pagerduty.com/
- This page (HTML): https://pipedream.com/apps/pagerduty
- Tools: 31 actions · 2 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: pagerduty`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "pagerduty",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Acknowledge Incident:
const result = await mcp.callTool({
  name: "pagerduty-acknowledge-incident",
  arguments: {
    incidentId: "Incident ID",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a PagerDuty endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.pagerduty.com/users/me

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkucGFnZXJkdXR5LmNvbS91c2Vycy9tZQ?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "pagerduty-acknowledge-incident",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    pagerduty: { authProvisionId: "apn_xxxxxxx" },
    incidentId: "Incident ID",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (31)

### `pagerduty-acknowledge-incident` — Acknowledge Incident (Write)

Deprecated — use Update Incident instead. Acknowledge an incident. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/acknowledge-incident.md

### `pagerduty-add-note-to-incident` — Add Note to Incident (Write)

Add a text note to an incident. Notes are visible in the incident timeline and useful for documenting investigation steps, resolution details, or handoff notes. Use List Incidents or Get Incident to find the incident ID. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/add-note-to-incident.md

### `pagerduty-create-incident` — Create Incident (Write)

Trigger a new incident on a PagerDuty service. Use List Services to find a service ID and List Escalation Policies to find a policy ID. Use List Priorities to find priority IDs. Set incidentKey to a stable value derived from the alert source (e.g. a hash of title + service ID) to prevent duplicate…

Full schema: https://pipedream.com/apps/pagerduty/actions/create-incident.md

### `pagerduty-create-schedule-override` — Create Schedule Override (Write)

Override a schedule layer to assign a specific user for a time window. Use List Schedules to find a schedule ID and List Users to find the user ID. Time params use ISO 8601 with explicit UTC offset, e.g. 2026-06-02T15:00:00-07:00. Always include the UTC offset — do not assume UTC; using the wrong…

Full schema: https://pipedream.com/apps/pagerduty/actions/create-schedule-override.md

### `pagerduty-create-service` — Create Service (Write)

Create a new PagerDuty service. A service represents a system or application that generates incidents. Use List Escalation Policies to find a valid escalation policy ID (required). Set autoResolveTimeout to 0 to disable auto-resolve. Set acknowledgementTimeout to 0 to disable re-triggering after…

Full schema: https://pipedream.com/apps/pagerduty/actions/create-service.md

### `pagerduty-find-oncall-user` — Find Oncall User (Read-only)

Find the user on call for a specific schedule. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/find-oncall-user.md

### `pagerduty-get-event-orchestration-service` — Get Event Orchestration for Service (Read-only)

Get the active event orchestration routing rules configured for a service. Event orchestration routes incoming events to the right responders based on conditions. Use List Services to discover service IDs. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/get-event-orchestration-service.md

### `pagerduty-get-incident` — Get Incident (Read-only)

Get full details for a single incident by ID, including its current status, urgency, assignments, and html_url. Use List Incidents to find the incident ID. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/get-incident.md

### `pagerduty-get-service-analytics` — Get Service Analytics (Read-only)

Get incident volume and MTTR (mean time to resolve) metrics for one or more services over a time range. Use List Services to discover service IDs. Time params use ISO 8601 with explicit UTC offset, e.g. 2026-06-02T15:00:00-07:00. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/get-service-analytics.md

### `pagerduty-list-escalation-policies` — List Escalation Policies (Read-only)

List escalation policies in the PagerDuty account. Supports both exact name match (name) and substring search (query), plus team filtering. Use policy IDs with Create Incident, Create Service, and Update Escalation Policy. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/list-escalation-policies.md

### `pagerduty-list-escalation-policy-id-options` — List Escalation Policy ID Options (Read-only)

Retrieves available options for the Escalation Policy ID field.

Full schema: https://pipedream.com/apps/pagerduty/actions/list-escalation-policy-id-options.md

### `pagerduty-list-incident-change-events` — List Incident Change Events (Read-only)

List change events (deployments, config changes) correlated to an incident. Change events show what changed in your systems around the time the incident was triggered. Use List Incidents or Get Incident to find the incident ID. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/list-incident-change-events.md

### `pagerduty-list-incident-workflows` — List Incident Workflows (Read-only)

List available incident automation workflows. Use workflow IDs with Start Incident Workflow to run automation on an active incident. Requires Business+ plan — accounts without this plan will receive empty results or a 402 error. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/list-incident-workflows.md

### `pagerduty-list-incidents` — List Incidents (Read-only)

List and filter incidents by status, urgency, service, or team. Default statuses are triggered and acknowledged (open incidents). Use List Services to discover service IDs and List Teams for team IDs. Time params use ISO 8601 with explicit UTC offset, e.g. 2026-06-02T15:00:00-07:00. See the…

Full schema: https://pipedream.com/apps/pagerduty/actions/list-incidents.md

### `pagerduty-list-log-entries` — List Log Entries (Read-only)

List log entries (the audit trail of actions taken on an incident or across the account). When incidentId is provided, scopes results to that incident's log entries. Otherwise returns account-wide log entries. Use List Incidents or Get Incident to find incident IDs. Time params use ISO 8601 with…

Full schema: https://pipedream.com/apps/pagerduty/actions/list-log-entries.md

### `pagerduty-list-oncall-schedule-id-options` — List On-Call Schedule ID Options (Read-only)

Retrieves available options for the On-Call Schedule ID field.

Full schema: https://pipedream.com/apps/pagerduty/actions/list-oncall-schedule-id-options.md

### `pagerduty-list-oncalls` — List On-Calls (Read-only)

List on-call entries — who is on call right now or during a given time window. Filterable by schedule IDs or escalation policy IDs. Use List Schedules to discover schedule IDs and List Escalation Policies to discover policy IDs. Time params use ISO 8601 with explicit UTC offset, e.g…

Full schema: https://pipedream.com/apps/pagerduty/actions/list-oncalls.md

### `pagerduty-list-priorities` — List Priorities (Read-only)

List the priority levels configured for this PagerDuty account. Returns priority IDs and names (e.g. P1, P2, critical) useful for Create Incident and Update Incident. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/list-priorities.md

### `pagerduty-list-schedules` — List Schedules (Read-only)

List on-call schedules in the PagerDuty account, optionally filtered by name. Returns schedule IDs and names useful for List On-Calls and Create Schedule Override. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/list-schedules.md

### `pagerduty-list-service-id-options` — List Service ID Options (Read-only)

Retrieves available options for the Service ID field.

Full schema: https://pipedream.com/apps/pagerduty/actions/list-service-id-options.md

### `pagerduty-list-services` — List Services (Read-only)

List services, optionally filtered by team or searched by name. Returns service IDs, names, status, and html_url. Use List Teams to discover team IDs for filtering. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/list-services.md

### `pagerduty-list-status-page-posts` — List Status Page Posts (Read-only)

List posts on a PagerDuty status page. Use List Status Pages to discover status page IDs. Set activeOnly: true to filter to currently active posts (client-side filter). Requires Business+ plan — accounts without this plan will receive empty results or a 402 error. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/list-status-page-posts.md

### `pagerduty-list-status-pages` — List Status Pages (Read-only)

List configured PagerDuty status pages. Use status page IDs with List Status Page Posts to retrieve posts on a specific page. Requires Business+ plan — accounts without this plan will receive empty results or a 402 error. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/list-status-pages.md

### `pagerduty-list-teams` — List Teams (Read-only)

List teams in the PagerDuty account, optionally filtered by name. Returns team IDs and names useful for filtering incidents, users, and services. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/list-teams.md

### `pagerduty-list-user-id-options` — List User ID Options (Read-only)

Retrieves available options for the User ID field.

Full schema: https://pipedream.com/apps/pagerduty/actions/list-user-id-options.md

### `pagerduty-list-users` — List Users (Read-only)

List users in the PagerDuty account, searchable by name or email. Returns user IDs, names, emails, and roles. Optionally filter by team membership using team IDs from List Teams. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/list-users.md

### `pagerduty-resolve-incident` — Resolve Incident (Write)

Deprecated — use Update Incident instead. Resolve an incident. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/resolve-incident.md

### `pagerduty-start-incident-workflow` — Start Incident Workflow (Write)

Start an automation workflow on an active incident. Use List Incident Workflows to discover available workflow IDs. Use List Incidents or Get Incident to find the incident ID. Requires Business+ plan — accounts without this plan will receive a 402 error. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/start-incident-workflow.md

### `pagerduty-trigger-incident` — Trigger Incident (Write)

Deprecated — use Create Incident instead. Trigger an incident. See the documentation

Full schema: https://pipedream.com/apps/pagerduty/actions/trigger-incident.md

### `pagerduty-update-escalation-policy` — Update Escalation Policy (Write)

Update an escalation policy's name, description, loop count, or escalation rules. By default, performs a read-then-merge: fetches the current policy and merges your changes before writing, so you only need to specify the fields you want to change. Set fullReplacement: true to replace all rules…

Full schema: https://pipedream.com/apps/pagerduty/actions/update-escalation-policy.md

### `pagerduty-update-incident` — Update Incident (Write)

Update an incident's status, title, urgency, priority, escalation policy, or assignments. Use List Incidents or Get Incident to find the incident ID. To acknowledge: set status to acknowledged. To resolve: set status to resolved. Use List Users to find user IDs for assignments and List Priorities…

Full schema: https://pipedream.com/apps/pagerduty/actions/update-incident.md

## Triggers (2)

### `pagerduty-new-oncall-rotation` — New On-Call Rotation (Polling)

Emit new event each time a new user rotates onto an on-call rotation

Full schema: https://pipedream.com/apps/pagerduty/triggers/new-oncall-rotation.md

### `pagerduty-new-or-updated-incident` — New or Updated Incident (Instant)

Emit new event each time an incident is created or updated

Full schema: https://pipedream.com/apps/pagerduty/triggers/new-or-updated-incident.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt