## Creating a Linear OAuth app

Linear supports OAuth2 authentication, which is the supported auth type by Apideck if you're looking build an integration with Linear that can be used by other companies.

## Prerequisites

Before you begin, make sure you have the following:

1. A Linear account - You can [sign up here](https://linear.app/signup).
2. An Apideck account

## 1. Log in to Linear

After you have signed up for a Linear, you can [log in to Linear](https://linear.app/login) to create an "Application".

## 2. Create an OAuth2 application in Linear

Create a new OAuth2 Application using the [following link](https://linear.app/settings/api/applications/new).

Fill out basic information about your OAuth app:
- Application name
- Developer name
- Developer website
- Description of the integration
- Redirect URI - use `https://unify.apideck.com/vault/callback`
- Logo 
- Toggle application is publicly visible
- Toggle refresh tokens
- Toggle webhooks if you're looking to integrate with webhooks

> **Note for existing integrations:** If your Linear OAuth app was created before March 2026, you must enable the "Allow refresh tokens" toggle in your Linear app settings before tokens can be migrated to the new short-lived format.

Click the create button.

**💡 TIP**: Copy the "Client ID" and the "Client secret". You will need them in the next step.

## 3. Configure the Linear connector in Apideck

[Enable the Linear connector](https://platform.apideck.com/configuration/issue-tracking/linear) in the Apideck Admin. 

Select **Use your Linear client credentials** and copy paste the Client ID and secret created in the previous step. 

Depending on the scope of your integration you will need to select scopes required for your use case.

Press "Save settings" to save your credentials.

## Vault Connection Testing

Now that you have your Linear connector configured, you can connect to your Linear account in a secure manner. You can start testing it by using Linear GraphQL API via our Proxy API.

Goto the Apideck > Configuration > Issue Tracking > [Linear](https://platform.apideck.com/configuration/issue-tracking/linear)

You can test the connection by clicking "Test Vault", which trigger the OAuth flow to give access to your Linear account for the consumer with ID `test-consumer`.

## Do your first API call

- To test the access token, make a call to the [`GraphQL API`](https://developers.linear.app/docs/graphql/working-with-the-graphql-api) endpoint using the [Proxy API](https://developers.apideck.com/apis/proxy/reference).

```
curl --location --request POST 'https://unify.apideck.com/proxy' \
--header 'x-apideck-consumer-id: test-consumer' \
--header 'x-apideck-app-id: {APIDECK_APP_ID}' \
--header 'x-apideck-service-id: linear' \
--header 'x-apideck-downstream-url: https://api.linear.app/graphql' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {APIDECK_API_KEY}' \
--data-raw '{"query":"{ viewer { id name } }","variables":{}}'
```

## Start building with the Linear API

Learn what else you can [build with the Linear API](https://developers.linear.app/docs/).

Interested in a personalized demo? [Let us know](https://www.apideck.com/demo-request?from=guide).