pagerduty

What it is and what it does

This is a Python client library for interacting with PagerDuty's public REST APIs. It wraps httpx2 to provide a higher-level abstraction that handles authentication, pagination, filtering, and automatic connection pooling, eliminating boilerplate code when making requests to PagerDuty. The library is designed to balance ease of use with direct access to the underlying HTTP client, so you can still inspect response headers or set custom request headers when needed.

The package includes both a programmatic API for use in Python applications and a command-line interface for triggering incidents and other Events API operations. It was built to replace code duplication in PagerDuty's own internal tooling and is the successor to the pdpyras library. It handles rate limiting with configurable cooldown and reattempt logic, and supports Python 3.10 through 3.13.

Use it for:

• Trigger incidents or send events to PagerDuty from Python applications or monitoring systems
• Query incidents, users, schedules, or other PagerDuty objects with built-in pagination and filtering
• Build automation scripts that interact with PagerDuty's REST API without managing HTTP details
• Integrate PagerDuty alerting into custom Python-based incident response workflows
• Use the CLI tool to trigger incidents directly from shell scripts or cron jobs

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Lightweight Python client library for PagerDuty's REST API v2 and Events API v2, with built-in support for authentication, pagination, rate limiting, and connection pooling.

Yes. The package is actively maintained, has low install friction, no known vulnerabilities, and is widely used (top 5000 on PyPI). It directly solves the problem of interacting with PagerDuty's APIs from Python. The only caveat is to verify the license treatment before use, since metadata indicates it is unclear despite the description stating MIT.

Install

pagerduty on PyPI

pip install pagerduty

uv add pagerduty

poetry add pagerduty

Installing pagerduty

Before you install

Low friction install with a single runtime dependency (httpx2). Actively maintained with a release within the last 30 days and support for modern Python versions (3.10+).

License in practice

License treatment is unclear in the metadata, though the description excerpt states the code is made available under the MIT License. Verify the actual license file in the repository before relying on this for compliance.

Quickstart

pip install pagerduty

from pagerduty import EventsAPIV2Client

client = EventsAPIV2Client(routing_key='your-routing-key')
client.trigger(description='Network latency is high')

Requires Python 3.10 or later; a valid PagerDuty routing key or API token is needed for authentication.

Verify before relying

• Whether license_spdx and license_raw being null reflects a packaging issue or genuine metadata gap in the repository
• Full scope of API endpoints and resources covered by the client abstraction layer
• Whether the CLI tool (pagerduty trigger, etc.) is feature-complete or limited to Events API v2

Package facts

Evidence: pagerduty-7.0.0-py3-none-any.whl

Tags

More WWW/HTTP packages