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:

Navigate to Workspace Settings by selecting your tenant and choosing Preferences.
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 Personal API key. You’ll provide it as described in Required Configuration Values.

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.example.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).

Under Data change events, ensure the following are checked:
- Issues
- Projects
- Comments
Copy the value of the Signing secret. You’ll provide it as described in Required Configuration Values.
Click on Create webhook to finalize the creation of this webhook.

Required Configuration Values

Enter these values in the Atolio Admin console (v4.24 and later), or send them to Atolio Support (your Deployment Engineer).

Value	Where to find it	Example / format	Secret
Workspace URL key	The workspace name in your Linear URL, `https://linear.app/<url-key>/`	`example`	No
Personal API key	Step 5, `Personal API keys`	Long random string	Yes
Webhook signing secret	Step 10, the webhook’s `Signing secret`	Long random string	Yes

Provided by Atolio: the webhook URL (e.g. https://relay.search.example.com/connectors/linear/default/callback/linear), used for the webhook in step 8.

Keep secrets secure: Share values marked “Yes” in the Secret column only through a password-manager share (e.g. 1Password) or another secure channel agreed with Atolio Support. Never send them in plain email, chat, or support tickets.

Configuration Example

Add this block to connector-values.yaml. Replace each <PLACEHOLDER> with the matching value from the table above, and remove any line marked “Only if” that doesn’t apply.

connectors:
  linear:
    default:
      linear:
        connector: linear
        instance: default
        source: linear
        common:
          enabled: true
          identity-provider: false
        secrets:
          token:
            value: "<PERSONAL_API_KEY>"
          webhook_secret:
            value: "<WEBHOOK_SIGNING_SECRET>"
        configuration:
          url-key: "<WORKSPACE_URL_KEY>"