Skip to content
Last updated

Linear integration

Linear is a modern project management tool designed for software teams to plan, track, and manage issues, projects, and workflows. Integrating Linear with Frontegg allows your application to access and manage issues, projects, and teams on behalf of your users through OAuth 2.0 authentication.


Prerequisites

  • A Linear account with admin access to a workspace
  • Access to the Linear workspace settings

Connect Linear

Step 1: Open the API settings

Log in to your Linear workspace. Click your workspace name in the top-left corner and select Settings. In the left sidebar, under Administration, click API. Scroll down to the OAuth Applications section and click New OAuth application.

Linear API settings

Step 2: Create a new application

In the Create new application form, fill in the following fields:

  • Application name — Enter a descriptive name (e.g., "Frontegg Integration")
  • Developer name — Enter your company name
  • Developer URL — Enter a link to your application or company homepage
  • Description — Enter a brief description of the integration

Linear application form

Step 3: Configure callback URLs

In the Callback URLs field, enter the following redirect URIs, each on a new line:

  • https://YOUR_MCP_GATEWAY_URL/integration-callback

Linear callback URLs

Step 4: Save the application

Click the Create button at the bottom of the form to save your application.

Linear create button

Step 5: Copy credentials

After creating the app, you are redirected to the application settings page. Here you can find the Client ID and Client Secret under the OAuth credentials section.

Copy the Client ID and Client Secret values. You will need them to configure the integration in the Frontegg portal.

Keep your credentials secure

Never share or commit your Client Secret to version control.

Linear OAuth credentials

Configure OAuth scopes

Linear supports the following OAuth scopes that define the level of access your application requests:

ScopeDescription
readRead access to the user's account
writeWrite access to the user's account
adminFull admin-level access

Minimum required scopes

For basic functionality, you need: read, write.

Configure the Frontegg portal

Once you have obtained your Client ID and Client Secret from the steps above, enter them in the integration configuration page of the Frontegg portal:

  1. Open the Frontegg portal and navigate to [ENVIRONMENT] → Integrations → Linear.
  2. Enter the Client ID and Client Secret in the corresponding fields.
  3. Select the required scopes.
  4. Click Save.

Additional resources