Linear

🚀 Quickstart

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

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Linear.

Nango has a Nango-managed OAuth app you can use in development and production. Select it when you create the integration.

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
Node

curl "https://api.nango.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 } } }"
      }'

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });

const res = await nango.post({
  endpoint: '/graphql',
  data: {
    "query": "query { issues(first: 10) { nodes { id title identifier } } }"
  },
  providerConfigKey: '<INTEGRATION-ID>',
  connectionId: '<CONNECTION-ID>'
});

console.log(JSON.stringify(res.data, 2, null));

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To use your own OAuth app instead of the Nango-managed one, follow the setup guide linked below.

Deleting a connection revokes its Linear access token by default. If multiple Nango connections share the same Linear authorization, deleting one of them would revoke it for all connections using it. To opt out of this for a given connection, set skipTokenRevocation: true in that connection’s metadata using the update connection metadata endpoint before deleting it.

📚 Linear Integration Guides

Nango maintained guides for common use cases.

How to register your own Linear OAuth app
Register an OAuth app with Linear and obtain credentials to connect it to Nango

Official docs: Linear API docs

🧩 Pre-built syncs & tools for Linear

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

Others

Function name	Description	Type
`add-issue-label`	Attach a label to a Linear issue.	Tool
`archive-cycle`	Archive a Linear cycle.	Tool
`archive-issue`	Archive a Linear issue so it is removed from active workflows.	Tool
`create-attachment`	Create an attachment on a Linear issue.	Tool
`create-comment`	Create a comment on a Linear issue.	Tool
`create-cycle`	Create a cycle for a Linear team.	Tool
`create-issue-label`	Create a Linear issue label.	Tool
`create-issue-relation`	Create a relationship between two Linear issues.	Tool
`create-issue`	Create a new Linear issue.	Tool
`create-project`	Create a Linear project.	Tool
`delete-attachment`	Delete an attachment from a Linear issue.	Tool
`delete-comment`	Delete a comment from a Linear issue.	Tool
`delete-issue-label`	Delete a Linear issue label.	Tool
`delete-issue-relation`	Delete a relationship between two Linear issues.	Tool
`delete-issue`	Delete a Linear issue.	Tool
`get-attachment`	Retrieve a Linear attachment by attachment ID.	Tool
`get-comment`	Retrieve a Linear comment by comment ID.	Tool
`get-cycle`	Retrieve a Linear cycle by cycle ID.	Tool
`get-issue-label`	Retrieve a Linear issue label by label ID.	Tool
`get-issue`	Retrieve a Linear issue by issue ID.	Tool
`get-project`	Retrieve a Linear project by project ID.	Tool
`get-team`	Retrieve a Linear team by team ID.	Tool
`get-user`	Retrieve a Linear user by user ID.	Tool
`get-viewer`	Retrieve the currently authenticated Linear user.	Tool
`get-workflow-state`	Retrieve a Linear workflow state by state ID.	Tool
`list-attachments`	List Linear attachments with filtering and pagination.	Tool
`list-comments`	List Linear comments with filtering and pagination.	Tool
`list-cycles`	List Linear cycles with filtering and pagination.	Tool
`list-issue-labels`	List Linear issue labels with filtering and pagination.	Tool
`list-issues`	List Linear issues with filtering and pagination.	Tool
`list-projects`	List Linear projects with filtering and pagination.	Tool
`list-teams`	List Linear teams available to the authenticated user.	Tool
`list-users`	List Linear users with filtering and pagination.	Tool
`list-workflow-states`	List Linear workflow states across teams.	Tool
`remove-issue-label`	Remove a label from a Linear issue.	Tool
`resolve-comment`	Resolve a Linear comment thread.	Tool
`search-issues`	Search Linear issues with full-text query support.	Tool
`unarchive-issue`	Restore an archived Linear issue.	Tool
`unarchive-project`	Restore an archived Linear project.	Tool
`unresolve-comment`	Reopen a previously resolved Linear comment thread.	Tool
`update-comment`	Update a comment on a Linear issue.	Tool
`update-cycle`	Update an existing Linear cycle.	Tool
`update-issue-label`	Update an existing Linear issue label.	Tool
`update-issue-relation`	Update fields on an existing Linear issue relation.	Tool
`update-issue`	Update fields on an existing Linear issue	Tool
`update-project`	Update an existing Linear project.	Tool
`cycles`	Sync Linear cycles for planning and iteration tracking.	Sync
`issue-labels`	Sync Linear issue labels across teams.	Sync
`issues`	Sync Linear issues with state, assignee, labels, project, and cycle data.	Sync
`milestones`	Sync Linear milestones for project planning.	Sync
`projects`	Sync Linear projects with lead, status, and progress fields	Sync
`roadmaps`	Sync Linear roadmaps and their project relationships.	Sync
`teams`	Sync Linear teams visible to the authenticated user.	Sync
`users`	Sync Linear users with profile and active state fields.	Sync
`workflow-states`	Sync Linear workflow states across teams.	Sync

Overview

1,000+ APIs & Integrations

🚀 Quickstart

📚 Linear Integration Guides

🧩 Pre-built syncs & tools for Linear

Others

​🚀 Quickstart

​📚 Linear Integration Guides

​🧩 Pre-built syncs & tools for Linear

​Others

🚀 Quickstart

📚 Linear Integration Guides

🧩 Pre-built syncs & tools for Linear

Others