Articles in this section

Set up a connection to Linear

Linear is a project management and issue-tracking tool that helps teams plan, track, and manage software development tasks efficiently.

Set up a connection

After you start the connection, configure it in the Create connection panel and complete all of the required * authentication settings:

Setting

Instructions

Name your connection *

Enter a clear and distinguishable name.

Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.

Auth type *

Select your Linear account authentication type (Token or OAuth 2.0).

Token authentication

API token *

Enter your Linear API key.

Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s key safe. When editing this form later, you must enter this key again; it is stored only when the connection is saved and never displayed as text.

dataLoad.svg​​ How to retrieve your API key

OAuth 2.0 authentication

OAuth 2.0 client *

Select the OAuth 2.0 client that stores the client ID and client secret provided to you by Linear.

To add an OAuth 2.0 client and configure your credentials, click the plus (+) button. Click the edit (pencil.svg) button to modify a selected OAuth 2.0 client. For more information, see Create an OAuth 2.0 iClient resource.

dataLoad.svg​​ How to retrieve the client ID and client secret

Scopes *

Scopes are OAuth 2.0 permissions that Linear defines to limit access to your account.

dataLoad.svg​​ How to configure the scopes

Tip

This connector documentation describes only the settings shown for the Simple view. For the corresponding HTTP settings, see the respective Token and OAuth 2.0 auth universal connector documentation.

How to retrieve the API key

  1. Sign in to your Linear account.

  2. Navigate to ProfileSettingsPreferencesSecurity and access.

  3. In Personal API keys, click New API key.

  4. Enter a Key name.

  5. Select the Permissions and Team access.

  6. Click Create.

  7. Copy the API key.

How to retrieve the client ID and client secret

  1. Sign in to your Linear account.

  2. Navigate to ProfileSettingsAdministrationAPI.

  3. In OAuth applications, click +.

  4. Enter an Application name and Developer name.

  5. Enter the Celigo Redirect URL.

  6. Click Create.

  7. Copy the Client ID.

  8. Copy the Client secret.

How to configure the scopes

  1. Click Scope.

  2. To access all of the scopes in the API, click the » button.

    – or –

    Check the scopes you want to add and click the > button.

  3. Click Save.

Additional reference