Skip to main content

PagerDuty

Connection

Setup

Klef reaches your account through PagerDuty’s REST API, with a general access API key that an admin or the account owner creates.
1
In PagerDuty, go to Integrations, then Developer Tools, then API Access Keys, and choose Create New API Key.
2
Describe the key as Klef’s, leave Read-only API Key unchecked, and choose Create Key.
3
Copy the key into Klef, with your account’s service region and the email of an admin, whom PagerDuty records as adding the users Klef creates.
PagerDuty keeps no deactivated user, so a user Klef switches off is deleted. PagerDuty refuses to delete a user with open incidents unless the account reassigns them on offboarding.

Permissions

Managing team membership is optional, and needs a PagerDuty plan that includes teams.

Settings

pagerduty.user

Fields

Default Account Matching Rules

When Klef adopts an account that already exists in PagerDuty, it works out whose it is by trying these in order. A connection can override them.

Examples

PagerDuty responders

A PagerDuty responder for every engineer, deleted when they leave.