> ## Documentation Index > Fetch the complete documentation index at: https://docs.stackone.com/llms.txt > Use this file to discover all available pages before exploring further. # Linear OAuth 2.0 connector profile – StackOne setup guide > Set up the OAuth 2.0 connector profile for Linear in StackOne. One-time admin setup required before your users can link Linear accounts via Hub. Workspace Admin access is required to create OAuth2 applications in Linear.
Select Actions to adjust the guide
Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.
Action
Scope(s)
Loading actions...
Dynamic Guide URL
Scopes Selected

          

            
Separator

Create an OAuth2 application

Register an OAuth2 application in Linear to obtain a Client ID and Client secret.

Sign in to your Linear account.

  • Click your avatar in the top-left corner and select Settings.

In the left sidebar under Administration, click API.

  • In the OAuth applications section, click the + (New OAuth application) button.
The API settings page with the New OAuth application button highlighted in the OAuth applications section.

Complete the Create new application form.

  • Application name: a user-visible name for your application, for example `StackOne`.
  • Developer name: the person or company developing this application.
  • Developer URL: your homepage or documentation URL, for example `https://yourcompany.com`.
  • In Redirect URIs, enter `https://api.stackone.com/connect/oauth2/linear/callback`.
  • Optionally add a Description.
  • Leave GitHub username blank and the Public, Client credentials, and Webhooks toggles off unless your integration specifically requires them.
  • Click Create.
The Create new application form with the Redirect URIs field populated with the StackOne callback URL.

After creating the application, open the OAuth credentials section and copy the values. Paste them into the Client ID and Client Secret fields in the StackOne Connector profile.

  • Use the Copy to clipboard button next to Client ID and Client secret.
  • Store the Client secret securely — it is only shown here and must never be shared publicly.
The OAuth credentials section showing the Client ID and Client secret each with a copy-to-clipboard button.
Enables actions: Archive Cycle, Archive Initiative, Archive Issue, Archive Project, Archive Project Status, Batch Create Issues, Batch Update Issues, Complete Release, Create Attachment, Create Comment, Create Custom View, Create Customer, Create Customer Need, Create Customer Status, Create Customer Tier, Create Cycle, Create Document, Create Favorite, Create Initiative, Create Initiative To Project Link, Create Initiative Update, Create Issue, Create Issue Label, Create Issue Relation, Create Notification Subscription, Create Organization Invite, Create Project, Create Project Label, Create Project Milestone, Create Project Status, Create Project Update, Create Reaction, Create Release, Create Team, Create Team Membership, Create Template, Create Webhook, Create Workflow State, Delete Attachment, Delete Comment, Delete Custom View, Delete Customer, Delete Customer Need, Delete Customer Status, Delete Customer Tier, Delete Document, Delete Favorite, Delete Initiative, Delete Initiative To Project Link, Delete Issue, Delete Issue Label, Delete Issue Relation, Delete Project, Delete Project Label, Delete Project Milestone, Delete Reaction, Delete Release, Delete Team, Delete Team Membership, Delete Template, Delete Webhook, File Upload, Get Agent Session, Get Application Info, Get Comment, Get Customer, Get Customer Need, Get Customer Status, Get Customer Tier, Get Cycle, Get Document, Get External User, Get Initiative, Get Issue, Get Issue Label, Get Project, Get Project Label, Get Project Milestone, Get Project Status, Get Team, Get Unified Credentials, Get User, Get Viewer, Get Webhook, Get Workflow State, Issue Filter Suggestion, List Agent Sessions, List Comments, List Customer Needs, List Customer Statuses, List Customer Tiers, List Customers, List Cycles, List Documents, List External Users, List Favorites, List Initiatives, List Issue Labels, List Issues, List Project Labels, List Project Milestones, List Project Statuses, List Projects, List Team Memberships, List Teams, List Users, List Webhooks, List Workflow States, Resolve Comment, Rotate Webhook Secret, Search Issues, Suspend User, Unarchive Issue, Unresolve Comment, Update Attachment, Update Comment, Update Custom View, Update Customer, Update Customer Need, Update Customer Status, Update Customer Tier, Update Cycle, Update Document, Update Initiative, Update Issue, Update Issue Label, Update Organization, Update Project, Update Project Label, Update Project Milestone, Update Project Status, Update Release, Update Team, Update Template, Update User, Update Webhook, Update Workflow State, Upsert Customer

In the Scopes field of the StackOne Connector profile, enter the comma-separated scopes this integration needs, or leave it blank to request the default `read,write,admin`. `read` grants read access to the account and is always present; `write` grants write access to create and update Linear resources; `issues:create` allows creating new issues and their attachments; `comments:create` allows creating new issue comments; and `admin` grants full access to admin-level endpoints. The `admin` scope is required for webhook management, updating workspace/organization settings, and creating or modifying customer statuses, customer tiers, and project statuses — these actions fail with an "admin required" error without it, even for workspace admins, because Linear treats admin as a separate token grant from the user's role. Leave `admin` in place to enable the full connector; remove it only if your integration never uses those admin-gated actions.
## Creating the StackOne Connector Profile To create the Connector Profile in StackOne for Linear: Login to StackOne and navigate to [Connector Profiles](https://app.stackone.com/connector_profiles)
  • Click + Connector Profile
  • Search for and select Linear
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
 Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Linear.