Linear Connector

Index teams, projects, issues, and comments in Linear.

The Linear connector indexes teams, projects, issues, and comments across your Linear workspace.

Note: Atolio currently uses an API key for this connector, but will support a published Integration in a future release.

Create the Linear API key & Webhooks

As an administrator:

  1. Navigate to Workspace Settings by selecting your tenant and choosing Preferences.
  2. Under My Account, click on API.

To create an API key, complete the following steps: 3. Under Personal API keys, provide a Label in the text box, e.g. Atolio. 4. Click on Create new API key. 5. Copy the value of the key to securely share with your Deployment Engineer.

To create a Webhook, complete the following steps: 6. Under Webhooks, click on Create new webhook. 7. Provide a Label in the text box, e.g. Atolio. 8. For URL, specify the URL provided by your Deployment Engineer. It will be similar to the following with your chosen DNS name:

  • https://relay.search.yourdomain.com/connectors/linear/default/callback/linear
  • Note: if you have multiple Linear instances, please make sure to provide the correct instance name in the URL above (i.e. default in the example).
  1. Under Data change events, ensure the following are checked:
    • Issues
    • Projects
    • Comments
  2. Copy the value of the Signing secret to securely share with your Deployment Engineer.
  3. Click on Create webhook to finalize the creation of this webhook.

Provide Configuration

Once the API key and Webhook have been created, provide these configuration values to your Deployment Engineer:

  • UrlKey is the name of your Linear workspace.
  • Token is the personal access token.
  • WebhookSecret is the webhook secret.