Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.alterauth.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Connect your users to Linear for issue tracking, project management, and team workflow automation.
PropertyValue
Provider IDlinear
CategoryProject Management
PKCESupported
Token refreshAutomatic
Redirect URIShown in Developer Portal

​
Step 1: Create a Linear OAuth App

1

Go to Linear API Settings

Navigate to Linear Settings > API > OAuth Applications and sign in.
2

Create a new OAuth application

Click Create new OAuth application. Enter your application name and description.
3

Add the callback URL

Add the Redirect URI from the Developer Portal to the Callback URLs field.
4

Get your credentials

Copy the Client ID and Client Secret from the application page.
Never share your Client Secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

​
Step 2: Add to Alter Vault

1

Open the Developer Portal

Go to portal.alterauth.com and navigate to your app.
2

Add Linear provider

Go to OAuth Providers > Add Provider > Linear.
3

Enter credentials

  • Client ID: Paste your Linear Client ID
  • Client Secret: Paste your Linear Client Secret
4

Select scopes

Choose the scopes your app needs.
5

Save

Click Save. The provider is now active.

​
Available Scopes

ScopeDescription
readRead access to your Linear data
writeWrite access to your Linear data
issues:createCreate new issues
adminAdmin access to workspace settings

​
Notes

  • Linear uses comma-separated scopes (handled automatically by Alter Vault).
  • Linear OAuth apps use rolling refresh tokens. Access tokens expire in 24 hours and are automatically refreshed by Alter Vault.
  • See the Linear OAuth documentation for more details.