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:

A Linear account - You can sign up here.
An Apideck account

1. Log in to Linear

After you have signed up for a Linear, you can log in to Linear to create an "Application".

2. Create an OAuth2 application in Linear

Create a new OAuth2 Application using the following link.

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 webhooks if you're looking to integrate with webhooks

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 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

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
```
endpoint using the Proxy API.

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.

Interested in a personalized demo? Let us know.