Skip to main content

Overview

Connect Linear to enable TierZero to create and reference issues during investigations. TierZero can create follow-up tickets, link related issues, and provide context from existing Linear issues.

Prerequisites

  • Administrative access to your Linear workspace
  • Permission to create API keys

Setup Instructions

Step 1: Navigate to Integration Settings

  1. Log into your TierZero dashboard
  2. Go to Settings → Integrations
  3. Click Connect next to Linear

Step 2: Create an API Key

  1. In Linear, go to Settings → API → Personal API Keys
  2. Click Create Key
  3. Name it (e.g., “TierZero Integration”)
  4. Copy the generated API key

Step 3: Enter Credentials

  1. Paste the API key into TierZero
  2. Click Connect

What TierZero Accesses

  • Issues: Read and create issues, add comments
  • Projects: List projects and teams
  • Labels: Issue labels and statuses
  • Users: Team member information for assignments

Security

  • TierZero uses API key authentication via Linear’s GraphQL API
  • Keys are encrypted at rest
  • Revoke by deleting the API key in Linear

Troubleshooting

API Key Not Working

  • Verify the API key was created as a Personal API Key (not an OAuth token)
  • Check that the key has not expired or been revoked