API Token

Setup
Reference

What You'll Need

Credential	Description
API Key	Personal API key from Linear settings

Overview

Connect to Linear’s GraphQL API for issue tracking and project management data.

Issues & Projects

Issues, projects, cycles, milestones

Teams & Users

Team structure, user assignments

Prerequisites

Administrator access required. You need privileges in to complete this setup.If you don’t have admin access, contact your administrator to:

Create the API credentials on your behalf, OR
Grant you temporary admin access to complete the setup

Admin role in Linear workspace (for full data access)
API keys are tied to your user account and its permissions

Setup Guide

Access Linear Settings

Go to Linear
Click your avatar → Settings
Navigate to Account → API

Create API Key

Click Create key
Enter label: Parable Integration
Click Create key

Copy your now!This is the only time it will be displayed. Store it in a secure password manager before closing this page.

Note Permissions

The API key inherits your account’s permissions:

Admin users have access to all workspace data
Member users have access based on team membership

For comprehensive data access, create the key with an admin account.

Verify Your Setup

curl -X POST "https://api.linear.app/graphql" \
  -H "Authorization: Bearer YOUR_LINEAR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ viewer { id email name } }"}'

Success! If you received a 200 OK response with valid data, your credentials are configured correctly. You can now proceed to configure this connector in Parable.

Rate Limits: enforces rate limits of .Parable handles rate limiting automatically with exponential backoff, but initial syncs of large datasets may take longer due to these limits.

GraphQL Examples

Query Issues with Details

query {
  issues(first: 100) {
    nodes {
      id
      title
      description
      state { name }
      assignee { name email }
      project { name }
      labels { nodes { name } }
      createdAt
      updatedAt
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

Query Team Members

query {
  users {
    nodes {
      id
      name
      email
      active
      admin
    }
  }
}

Troubleshooting

Error	Meaning	Solution
`Authentication required`	Missing or invalid token	Verify API key in header
`Forbidden`	Insufficient permissions	Use admin account or check team access
`Rate limit exceeded`	Too many requests	Implement backoff

Common Issues

Can’t see certain teams

API keys inherit user permissions. If you can’t see certain teams, verify the user account has access.

GraphQL errors

Check your query syntax. Use Linear’s API explorer to test queries.

Additional Resources

Linear API

Official API documentation

GraphQL Schema

GraphQL reference

Connectors

Encryption

What You'll Need

Overview

Issues & Projects

Teams & Users

Prerequisites

Setup Guide

Verify Your Setup

GraphQL Examples

Troubleshooting

Can’t see certain teams

GraphQL errors

Additional Resources

Linear API

GraphQL Schema

Connectors

Encryption

What You'll Need

​Overview

Issues & Projects

Teams & Users

​Prerequisites

​Setup Guide

​Verify Your Setup

​GraphQL Examples

​Troubleshooting

​Can’t see certain teams

​GraphQL errors

​Additional Resources

Linear API

GraphQL Schema

Overview

Prerequisites

Setup Guide

Verify Your Setup

GraphQL Examples

Troubleshooting

Can’t see certain teams

GraphQL errors

Additional Resources