Linear

Integrate your application with the Linear API

🚀 Quickstart

Connect to Linear with Tenklo and see data flow in 2 minutes.

Create the integration

In Tenklo (free signup), go to Integrations -> Configure New Integration -> Linear. Tenklo doesn't provide a test OAuth app for Linear yet. You'll need to set up your own by following the setup guide. After that, make sure to add the OAuth client ID, secret, and scopes in the integration settings in Tenklo.

Authorize Linear

Go to Connections -> Add Test Connection -> Authorize, then log in to Linear. Later, you'll let your users do the same directly from your app.

Call the Linear API

Let's make your first request to the Linear API (fetch a list of issues). Replace the placeholders below with your Environment API key, integration ID, and connection ID:

curl "https://api.tenklo.dev/proxy/graphql" \
  -H "Authorization: Bearer <NANGO-API-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>" \
  -H "Content-Type: application/json" \
  -d '{
        "query": "query { issues(first: 10) { nodes { id title identifier } } }"
      }'

Or fetch credentials with the Node SDK or API.

✅ You're connected! Check the Logs tab in Tenklo to inspect requests.

Implement Tenklo in your app

Follow our Auth implementation guide to integrate Tenklo in your app.

To obtain your own production credentials, follow the setup guide linked below.

📚 Linear Integration Guides

Tenklo maintained guides for common use cases.

Official docs: Linear API docs

🧩 Pre-built syncs & actions for Linear

Explore Nango-provided actions in your dashboard. Extend and customize them to fit your needs.

Others

Function nameDescriptionTypeSource code
add-issue-labelAttach a label to a Linear issue.Action🔗 Github
archive-cycleArchive a Linear cycle.Action🔗 Github
archive-issueArchive a Linear issue so it is removed from active workflows.Action🔗 Github
create-attachmentCreate an attachment on a Linear issue.Action🔗 Github
create-commentCreate a comment on a Linear issue.Action🔗 Github
create-cycleCreate a cycle for a Linear team.Action🔗 Github
create-issue-labelCreate a Linear issue label.Action🔗 Github
create-issue-relationCreate a relationship between two Linear issues.Action🔗 Github
create-issueCreate a new Linear issue.Action🔗 Github
create-projectCreate a Linear project.Action🔗 Github
delete-attachmentDelete an attachment from a Linear issue.Action🔗 Github
delete-commentDelete a comment from a Linear issue.Action🔗 Github
delete-issue-labelDelete a Linear issue label.Action🔗 Github
delete-issue-relationDelete a relationship between two Linear issues.Action🔗 Github
delete-issueDelete a Linear issue.Action🔗 Github
get-attachmentRetrieve a Linear attachment by attachment ID.Action🔗 Github
get-commentRetrieve a Linear comment by comment ID.Action🔗 Github
get-cycleRetrieve a Linear cycle by cycle ID.Action🔗 Github
get-issue-labelRetrieve a Linear issue label by label ID.Action🔗 Github
get-issueRetrieve a Linear issue by issue ID.Action🔗 Github
get-projectRetrieve a Linear project by project ID.Action🔗 Github
get-teamRetrieve a Linear team by team ID.Action🔗 Github
get-userRetrieve a Linear user by user ID.Action🔗 Github
get-viewerRetrieve the currently authenticated Linear user.Action🔗 Github
get-workflow-stateRetrieve a Linear workflow state by state ID.Action🔗 Github
list-attachmentsList Linear attachments with filtering and pagination.Action🔗 Github
list-commentsList Linear comments with filtering and pagination.Action🔗 Github
list-cyclesList Linear cycles with filtering and pagination.Action🔗 Github
list-issue-labelsList Linear issue labels with filtering and pagination.Action🔗 Github
list-issuesList Linear issues with filtering and pagination.Action🔗 Github
list-projectsList Linear projects with filtering and pagination.Action🔗 Github
list-teamsList Linear teams available to the authenticated user.Action🔗 Github
list-usersList Linear users with filtering and pagination.Action🔗 Github
list-workflow-statesList Linear workflow states across teams.Action🔗 Github
remove-issue-labelRemove a label from a Linear issue.Action🔗 Github
resolve-commentResolve a Linear comment thread.Action🔗 Github
search-issuesSearch Linear issues with full-text query support.Action🔗 Github
unarchive-issueRestore an archived Linear issue.Action🔗 Github
unarchive-projectRestore an archived Linear project.Action🔗 Github
unresolve-commentReopen a previously resolved Linear comment thread.Action🔗 Github
update-commentUpdate a comment on a Linear issue.Action🔗 Github
update-cycleUpdate an existing Linear cycle.Action🔗 Github
update-issue-labelUpdate an existing Linear issue label.Action🔗 Github
update-issue-relationUpdate fields on an existing Linear issue relation.Action🔗 Github
update-issueUpdate fields on an existing Linear issueAction🔗 Github
update-projectUpdate an existing Linear project.Action🔗 Github
cyclesSync Linear cycles for planning and iteration tracking.Sync🔗 Github
issue-labelsSync Linear issue labels across teams.Sync🔗 Github
issuesSync Linear issues with state, assignee, labels, project, and cycle data.Sync🔗 Github
milestonesSync Linear milestones for project planning.Sync🔗 Github
projectsSync Linear projects with lead, status, and progress fieldsSync🔗 Github
roadmapsSync Linear roadmaps and their project relationships.Sync🔗 Github
teamsSync Linear teams visible to the authenticated user.Sync🔗 Github
usersSync Linear users with profile and active state fields.Sync🔗 Github
workflow-statesSync Linear workflow states across teams.Sync🔗 Github

On this page