Paragon
Search…
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.
1
// You can find your project ID in the Overview tab of any Integration
2
3
// Authenticate the user
4
paragon.authenticate(<ProjectId>, <UserToken>);
5
6
// Get all issues associated with a given team ID
7
paragon.request("linear", "/", {
8
method: "POST",
9
body: {
10
"query": `
11
query Team {
12
team(id: "<Team ID>") {
13
id
14
name
15
16
issues {
17
nodes {
18
id
19
title
20
description
21
assignee {
22
id
23
name
24
}
25
createdAt
26
archivedAt
27
}
28
}
29
}
30
}`
31
}
32
});
33
34
// Get an issue by ID
35
paragon.request("linear", "/", {
36
method: "POST",
37
body: {
38
"query": `query Issue {
39
issue(id: "<Issue ID>") {
40
id
41
title
42
description
43
}
44
}`
45
}
46
});
47
Copied!

Building Linear workflows

Once your Linear account is connected, you use the Linear Request step to access any of Linear's API endpoints without the authentication piece.
When creating or updating records in Linear, you can reference data from previous steps by typing {{ to invoke the variable menu.
Last modified 10d ago