PagerDuty

Monitoring API key, or an Events routing key

Create and resolve incidents, and manage services, schedules and escalation policies, in PagerDuty from any Windmill script, flow or app.

Set up in 3 steps

Create an API key

In PagerDuty, open Integrations then API Access Keys, and create one. Note the login email of a PagerDuty user too — the REST API requires it as the From header on writes.

Add the resource in Windmill

Open Resources, add a resource of type pagerduty, and fill token and from_email.

Run your first script

Fork any script below and read before writing anything.

Scripts

Building blocks, if none of the projects above fit. Fork one, run it, or call it as a step inside your own flow.

Trigger flows from PagerDuty

PagerDuty is not only a destination. These inbound paths are supported today.

Alerts from your own jobs

The Events API scripts take a routing key rather than an API key, so a failing flow can trigger, acknowledge or resolve an alert on one service without any account-wide credential.

Resource type

pagerduty — the shape of the credential every script on this page expects.

View raw schema →

Field	Type	Required	What it is
from_email	string	No	Login email of a valid PagerDuty user. Sent as the `From` header on incident write actions; required when using an account-scoped (general access) API key, ignored for user-scoped keys.
token	string	Yes	PagerDuty REST API key. Create one under Integrations → API Access Keys (account-scoped) or My Profile → User Settings → Create API User Token (user-scoped). https://support.pagerduty.com/docs/api-access-keys

All resource types

PagerDuty

PagerDuty Events

Questions

Which resource do I need?

pagerduty for the REST API — incidents, services, schedules. pagerduty_events for firing alerts at one service, which needs only that service's routing key and nothing else.

A write fails without from_email

PagerDuty attributes writes to a user, sent as a From header. It has to be the login email of a real PagerDuty user, not an alias.

Is my token stored on the hub?

Never. It lives only in your own Windmill workspace, encrypted at rest.

Set up in 3 steps

Create an API key

Add the resource in Windmill

Run your first script

Scripts

Trigger Incident

Resolve Incident

Acknowledge Incident

Find Oncall User

New or Updated Incident

Update Incident

Trigger Event (Events API v2)

Resolve Event (Events API v2)

List Users

List Teams

List Services

List Schedules

List Priorities

List On-Calls

List Incidents

List Escalation Policies

Get Incident

Create Service

Create Schedule Override

Create Incident

Add Note to Incident

Acknowledge Event (Events API v2)

Acknowledge Event (Events API v2)

Add Note to Incident

Create Incident

Create Schedule Override

Create Service

Get Incident

List Escalation Policies

List Incidents

Trigger flows from PagerDuty

Alerts from your own jobs

Resource type

All resource types

PagerDuty

PagerDuty Events

Questions