Integration Guide: Linear

Overview

The Linear integration connects Tello IAM to your Linear workspace using SCIM provisioning. The connection requires a SCIM Base URL and a SCIM API Token, both found in Linear’s SAML & SCIM configuration settings.

Before connecting

The Administrator completing this setup must have Admin access to the Linear workspace. SAML & SCIM must be configured in Linear before the required credentials are available.

Step 1: Obtain SCIM credentials from Linear

1. Sign in to Linear and navigate to Settings → Administration → Security → SAML & SCIM configuration.
2. Select View configuration to reveal the SCIM credentials.
3. Copy the SCIM Base URL and the SCIM API Token (Bearer token).

Important: Copy the SCIM API Token before leaving this page. If lost, a new token must be generated.

Step 2: Connect Linear in Tello IAM

1. Navigate to Integrations in the left navigation.
2. Select + Add Integration.
3. Search for Linear and select Add.
4. Enter the SCIM Base URL in the SCIM Base URL field.
5. Enter the SCIM API Token in the SCIM API Token field.
6. Select Test Connection to verify both values are valid. A Connection successful confirmation will appear if accepted.
7. Select Connect. The integration appears on the Integrations page and an initial sync begins automatically.

Verify the connection

After the initial sync completes, confirm the following on the Integrations page:

• The Linear integration displays a status of Active
• A sync timestamp is present and reflects the completed sync
• User records on the Users page display detected Linear permissions in the Access column

Reauthorizing the connection

If the Linear integration loses authorization, it will display an error on the Integrations page. To reauthorize, generate a new SCIM API Token in Linear security settings, then select the integration row in Tello IAM, select Configure, and enter the new token.

Related articles

• Configuring Integrations — manage sync schedules, drift detection, and integration settings
• Understanding Errors — resolve integration errors and authorization failures