OAuth providers
Linear
Set up Linear OAuth for issue tracking and project management
Overview
Section titled “Overview”Connect your users to Linear for issue tracking, project management, and team workflow automation.
| Property | Value |
|---|---|
| Provider ID | linear |
| Category | Project Management |
| PKCE | Supported |
| Token refresh | Automatic |
| Redirect URI | Shown in Developer Portal |
Step 1: Create a Linear OAuth App
Section titled “Step 1: Create a Linear OAuth App”Go to Linear API Settings
Navigate to Linear Settings > API > OAuth Applications and sign in.
Create a new OAuth application
Click Create new OAuth application. Enter the application name and description.
Add the callback URL
Add the Redirect URI from the Developer Portal to the Callback URLs field.
Get credentials
Copy the Client ID and Client Secret from the application page.
Step 2: Add to Alter Vault
Section titled “Step 2: Add to Alter Vault”Open the Developer Portal
Go to portal.alterauth.com and navigate to the application.
Add Linear provider
Go to OAuth Providers > Add Provider > Linear.
Enter credentials
- Client ID: Paste your Linear Client ID
- Client Secret: Paste your Linear Client Secret
Select scopes
Choose the scopes the application needs.
Save
Click Save. The provider is now active.
Available Scopes
Section titled “Available Scopes”| Scope | Description |
|---|---|
read | Read access to your Linear data |
write | Write access to your Linear data |
issues:create | Create new issues |
admin | Admin access to workspace settings |
- 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.