Linear Setup Guide

Prerequisites

• A Linear workspace with admin permissions.
• The Customers feature enabled in that workspace. A valid API key authenticates against a workspace without it, but every write is refused.

Setup Guide

Step 1: Enable Customers in Linear

1. Sign in to your Linear workspace.
2. Navigate to Settings > Features.
3. Turn on Customers.

Step 2: Obtain an API Key from Linear

1. Navigate to Settings > Security & access.
2. Under Personal API keys, click on New API key.
3. Enter a descriptive name like Matia-Integration.
4. Click Create.
5. Copy the generated API key - Linear displays it only once, and you will need it to configure your connection.

Step 3: Complete Configuration in Matia

1. Enter the API Key you just obtained from Linear.
2. Enter an Asset Name.
3. (Optional) Enter a Description.
4. (Optional) Assign Tags.
5. Select an Owner.
6. Verify that your Linear account is successfully connected by clicking on Test Connection.
7. Click Connect.