View as Markdown
PagerDuty icon

PagerDuty TRIGGER

New On-Call Rotation

Emit new event each time a new user rotates onto an on-call rotation
  • Trigger
  • Polling
  • OAuth
  • Webhook delivery

IMPLEMENTATION

Deploy this event source

Connect the user's PagerDuty account, configure the source, and choose the webhook where your backend receives events.

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 deployed = await pd.triggers.deploy({
  id: "pagerduty-new-oncall-rotation",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    pagerduty: { authProvisionId: "apn_xxxxxxx" },
    escalationPoliciesIds: ["Escalation Policies"],
    timer: { "intervalSeconds": 900 },
  },
  webhookUrl: "https://example.com/webhooks/pagerduty",
})

console.log(deployed.id)

MCP exposes on-demand actions. Event sources are deployed through the Connect SDK or API because they continue listening after the initial request.

SCHEMA

Configuration

These inputs define which events the source watches. Dynamic options are loaded from the connected account.

New On-Call Rotation configuration
Property Type Description
escalationPoliciesIds Escalation Policies string[]
To filter your on-call rotations to specific escalation policies, select them here. To listen for rotations across all escalation policies, leave this blank.
Optional Dynamic
timer Interval to poll for new rotations $.interface.timer
The PagerDuty API doesn't support webhook notifications for on-call rotations, so we must poll the API to check for these changes. Change this interval according to your needs.
Required

01

Connect

Your user authorizes PagerDuty through Pipedream managed auth.

02

Deploy

Your backend deploys this source with that user's own configuration.

03

Webhook delivery

Every event is sent to the HTTP endpoint you choose when you deploy the source — after each poll.

OR

On-demand retrieval

No webhook required. Your app or agent can fetch recent events from the trigger events API.

Registry key
pagerduty-new-oncall-rotation
Version
0.1.2
App
PagerDuty
Authentication
OAuth
Delivery
Polling source
Output
Events emitted by PagerDuty.