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

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.