Skip to main content
  • 🚀 Quickstart
  • 🧑‍💻 OAuth app setup
  • 🚨 API gotchas
1

Create an 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 these instructions. 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
  • Node
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 dynamically via the Node SDK or API.
✅ You’re connected! Check the Logs tab in Nango to inspect requests.
Next step: Embed the auth flow in your app to let your users connect their Linear accounts.
Questions? Join us in the Slack community.
I