Get Credentials

This guide walks you through obtaining all required credentials for the PagerDuty plugin.

Authentication Method

The PagerDuty plugin uses API key authentication.

api_key (default) — REST API token sent as Authorization: Token token=<token>

Log in to PagerDuty.
Open your user menu → User settings → User settings (or API access / Personal settings depending on UI).
Under API Access, create a new API token (General Access with REST API, or the token type your organization allows for automation).
Copy the token when shown — you may not be able to view it again.

Use a token with at least the permissions required for the incidents, notes, and log-entry operations you plan to call. Storing credentials:

pnpm corsair setup --plugin=pagerduty api_key=your-api-token

Verify:

pnpm corsair auth --plugin=pagerduty --credentials

PagerDuty v3 webhooks can be verified using a signing secret associated with your webhook subscription.

In PagerDuty, open Integrations → Generic Webhooks (or your webhook subscription type).
Create or edit a subscription pointing at your HTTPS endpoint.
Copy the signing secret (or signing key) PagerDuty provides for verifying X-Pagerduty-Signature.

Storing credentials:

pnpm corsair setup --plugin=pagerduty webhook_signature=your-signing-secret

Credential	Required for	Where to find
REST API token	`api_key` auth	User settings → API access
Webhook signing secret	Webhooks	Webhook subscription details

For general information about how Corsair handles authentication, see Authentication.