​
Setup Guide

You can find your Linear app credentials in your Linear Developer Account.

You’ll need the following information to set up your Linear App with Paragon Connect:

  • Client ID
  • Client Secret
  • Scopes Requested

​
Add your Linear app to Paragon

Under Integrations > Connected Integrations > Linear > Settings, fill out your credentials from your developer app in their respective sections:

  • Client ID: Found under Production > Client ID on your Linear App page.
  • Client Secret: Found under Production > Client Secret on your Linear App page.
  • Permissions: Select the scopes you’ve requested for your application. For a list of recommended scopes, please view this integration within your Paragon dashboard. View dashboard.

Leaving the Client ID and Client Secret blank will use Paragon development keys.

​
Connecting to Linear

Once your users have connected their Linear account, you can use the Paragon SDK to access the Linear API on behalf of connected users.

See the Linear REST API documentation for their full API reference.

Any Linear API endpoints can be accessed with the Paragon SDK as shown in this example.

// You can find your project ID in the Overview tab of any Integration

// Authenticate the user
paragon.authenticate(<ProjectId>, <UserToken>);
            
// Get all issues associated with a given team ID
paragon.request("linear", "/", {
  method: "POST",
  body: {
    "query": `
      query Team {
      team(id: "<Team ID>") {
        id
        name
    
        issues {
          nodes {
            id
            title
            description
            assignee {
              id
              name
            }
            createdAt
            archivedAt
          }
        }
      }
    }` 
  }
});

// Get an issue by ID
paragon.request("linear", "/", {
  method: "POST",
  body: {
    "query": `query Issue {
      issue(id: "<Issue ID>") {
        id
        title
        description
      }
    }`
  }
});

​
Building Linear workflows

Once your Linear account is connected, you can add steps to perform the following actions:

  • Create Issue
  • Update Issue
  • Get Issue by ID
  • Get Issue by Issue Identifier
  • Search Issues
  • Delete Issue
  • Archive Issue
  • Create Sub-Issue
  • Create Project
  • Update Project
  • Get Project by ID
  • Delete Project

When creating or updating issues and projects in Linear, you can reference data from previous steps by typing {{ to invoke the variable menu.

​
Using Webhook Triggers

Webhook triggers can be used to run workflows based on events in your users’ Linear account. For example, you might want to trigger a workflow whenever new issues are created in Linear to sync your users’ Linear issues to your application in real-time.

You can find the full list of Webhook Triggers for Linear below:

  • Issue Created
  • Issue Status Updated
  • Label Added or Removed from Issue
  • Issue Deleted