PagerDuty Connector
Prerequisites
- A PagerDuty account (any plan)
- Admin or Account Owner access to create API keys
Getting Your Credentials
PagerDuty uses a REST API Key (v2) for authentication.
- Log into PagerDuty
- Go to Integrations > API Access Keys
- Click Create New API Key
- Enter a description (e.g.,
Landed sync) - Select Read-only API Key (recommended)
- Click Create Key
- Copy the key (starts with
u+)
Important: PagerDuty only shows the full API key once at creation. Save it securely.
Required Permissions
A read-only API key provides access to all the data Landed syncs. If you use a full-access key, Landed will still only read data.
Configuration in Landed
| Field | Value |
|---|---|
| API Key | Your PagerDuty REST API key (e.g., u+xxxxxxxxxxxxxxxx) |
Available Streams
| Stream | Description | Sync Mode |
|---|---|---|
incidents | Incident records with status, urgency, priority, assignments | Incremental |
services | Service definitions with escalation policies | Full refresh |
users | User records with role, contact info | Full refresh |
teams | Team definitions | Full refresh |
escalation_policies | Escalation policy definitions with rules | Full refresh |
schedules | On-call schedule definitions | Full refresh |
log_entries | Incident log entries (acknowledge, resolve, escalate events) | Incremental |
Common Issues
| Symptom | Cause | Fix |
|---|---|---|
401 Unauthorized | Invalid or expired API key | Generate a new key in PagerDuty > Integrations > API Access Keys |
403 Forbidden | Key lacks required permissions | Create a new read-only API key with admin access |
| Missing incidents | Incidents older than backfill window | PagerDuty paginates incidents; large histories are fetched in 30-day windows |
Rate limit exceeded | Too many API calls | Landed handles rate limiting automatically |
| Truncated results | PagerDuty caps offset pagination at 10,000 records | For streams with >10,000 records, Landed uses time-windowed pagination |
Static IPs for Allowlisting
If your PagerDuty configuration requires IP allowlisting:
- Production:
34.170.185.84,35.192.90.94 - Staging:
34.171.93.34