Paragon
Search…
⌃K
Links

Linear

Connect to your users' Linear accounts

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 > {YOUR_APP} > 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.
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.
Last modified 3mo ago