## 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](https://linear.app) 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](/assets/linear-1.d12b578b78cd38723a8c149da4cd7b6491df7fa74d199fe4df378a497ce4c2af.1ce25488.png)

#### 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](/assets/linear-3.9867804626228b3f2d1006987d1b52bc2971cf0f9499adeaec556a0afd4ce254.1ce25488.png)

#### 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](/assets/linear-4.24bff9e765926ee2fb0db370baedc6222735de548eed61021d33459af473e0f7.1ce25488.png)

#### Step 4: Save the application

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

![Linear create button](/assets/linear-5.4f67d7cdc2f1207babdf5745d8d2a0992198318cec9372fd4da69e4400ad9b0a.1ce25488.png)

#### 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](/assets/linear-7.6b183627cc5b04985781c0592bf272296a8671427c09a28194208f1f1f17953c.1ce25488.png)

### Configure OAuth scopes

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

| Scope | Description |
|  --- | --- |
| `read` | Read access to the user's account |
| `write` | Write access to the user's account |
| `admin` | Full 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

- [Linear developers portal](https://linear.app/developers)
- [Linear OAuth 2.0 authentication guide](https://linear.app/developers/oauth-2-0-authentication)
- [Linear GraphQL API reference](https://studio.apollographql.com/public/Linear-API/variant/current/home)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)