Prerequisites

Before setting up Integration Hub, ensure you have the required accounts and permissions.

Required Accounts

PagerDuty Account

• Account Type: Professional, Business, or Enterprise plan
• Permissions Required:
  • Create and manage services
  • Create and manage integrations
  • OAuth app access
• Role: Manager, Admin, or Global Admin

Linear Account

• Workspace Access: Member or Admin role
• Permissions Required:
  • Read and write issues
  • Create and manage webhooks
  • OAuth app access
• Teams: Access to teams you want to integrate

Technical Requirements

Browser Support

• Chrome/Edge: Latest 2 versions
• Firefox: Latest 2 versions
• Safari: Latest 2 versions

Network Requirements

• HTTPS access to PagerDuty and Linear APIs
• Ability to receive webhooks from Linear
• OAuth redirect URLs configured

Planning Your Integration

Identify Your Teams

Determine which Linear teams should be integrated with PagerDuty. You'll create one webhook per team.

Define Your Incident Criteria

Decide which Linear issues should create PagerDuty incidents:

• Which priorities? (Urgent, High, Medium, Low)
• Which statuses? (Triage, Todo, In Progress)
• Which projects? (Specific projects or all)
• Which labels? (Production, Critical, etc.)

Map Your Services

Identify which PagerDuty services should receive incidents from each Linear team.

Checklist

Next Steps

Once you have everything ready:

1. Connect Your PagerDuty Account →
2. Connect Your Linear Workspace →