Skip to main content

​
🚀 Quickstart

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

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Linear. Nango 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 Nango.
2

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.
3

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 secret key, integration ID, and connection ID:
curl "https://api.nango.dev/proxy/graphql" \
  -H "Authorization: Bearer <NANGO-SECRET-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 Nango to inspect requests.
4

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

​
📚 Linear Integration Guides

Nango maintained guides for common use cases. Official docs: Linear API docs

​
🧩 Pre-built syncs & actions for Linear

Enable them in your dashboard. Extend and customize to fit your needs.

​
Fields

Function nameDescriptionTypeSource code
fetch-fieldsIntrospection endpoint to fetch the fields available per a modelAction🔗 Github

​
Issues

Function nameDescriptionTypeSource code
create-issueCreate an issue in LinearAction🔗 Github
issuesFetches a list of issues from LinearSync🔗 Github

​
Milestones

Function nameDescriptionTypeSource code
milestonesFetches a list of milesontes from LinearSync🔗 Github

​
Models

Function nameDescriptionTypeSource code
fetch-modelsIntrospection endpoint to fetch the models availableAction🔗 Github

​
Projects

Function nameDescriptionTypeSource code
projectsFetches a list of projects from LinearSync🔗 Github

​
Roadmaps

Function nameDescriptionTypeSource code
roadmapsFetches a list of roadmaps from LinearSync🔗 Github

​
Teams

Function nameDescriptionTypeSource code
fetch-teamsFetch the teams from LinearAction🔗 Github
teamsFetches a list of teams from LinearSync🔗 Github

​
Users

Function nameDescriptionTypeSource code
usersFetches a list of users from LinearSync🔗 Github