Linear

Integrate your application with the Linear API

🚀 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

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

• 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 & actions for Linear

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

Fields

Function name	Description	Type	Source code
fetch-fields	Introspection endpoint to fetch the fields available per a model	Action	🔗 Github

Issues

Function name	Description	Type	Source code
create-issue	Create an issue in Linear	Action	🔗 Github
issues	Fetches a list of issues from Linear	Sync	🔗 Github

Milestones

Function name	Description	Type	Source code
milestones	Fetches a list of milesontes from Linear	Sync	🔗 Github

Models

Function name	Description	Type	Source code
fetch-models	Introspection endpoint to fetch the models available	Action	🔗 Github

Projects

Function name	Description	Type	Source code
projects	Fetches a list of projects from Linear	Sync	🔗 Github

Roadmaps

Function name	Description	Type	Source code
roadmaps	Fetches a list of roadmaps from Linear	Sync	🔗 Github

Teams

Function name	Description	Type	Source code
fetch-teams	Fetch the teams from Linear	Action	🔗 Github
teams	Fetches a list of teams from Linear	Sync	🔗 Github

Users

Function name	Description	Type	Source code
users	Fetches a list of users from Linear	Sync	🔗 Github

---