View as Markdown
PagerDuty icon

PagerDuty ACTION

List Escalation Policies

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
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's PagerDuty account once, then configure and run List Escalation Policies from your backend or agent.

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-list-escalation-policies",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    pagerduty: { authProvisionId: "apn_xxxxxxx" },
    name: "Name (Exact)",
    query: "Search Query",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

List Escalation Policies inputs
Property Type Description
name Name (Exact) string
Filter to the policy with exactly this name.
Optional
query Search Query string
Filter policies by name substring.
Optional
teamIds Team IDs string[]
Filter to policies belonging to these teams (e.g., ["PABC123","PDEF456"]).
Optional
limit Limit integer
Maximum number of results to return (1–100). Default: 25.
Optional
offset Offset integer
Pagination offset. Default: 0.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
pagerduty-list-escalation-policies
Version
0.0.2
App
PagerDuty
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes