Skip to content

Integrating SailPoint with Linear

Linear is a purpose-built tool for planning and building products, designed to streamline software projects, sprints, and roadmaps. It enables product teams to manage issues, automate workflows, and collaborate effectively. This document provides instructions to configure a new direct connection to a Linear source. For a reference to the terminology specific to SailPoint products, refer to Source and Connector Definitions.

Note

To view the latest features, enhancements, and fixes for all SaaS connectors, refer to the SaaS Release Notes page.

Supported Features

The Linear connector supports the following:

Account Management

  • Aggregate Accounts

Entitlement Management

  • Aggregate Teams

Important

Quick Compliance connectors have the following manual aggregation limits within a 24-hour period:

  • Organization Admins: Limited to 3 manual account or entitlement aggregations per day per source. This limit is cumulative across all admins in the organization.
  • Regular Users: Limited to 1 manual account or entitlement aggregation per day per source.

These limits ensure that individual compliance statuses are kept up to date while maintaining continuous compliance monitoring. If you need to run additional aggregations beyond these limits, contact SailPoint Support.

Prerequisites

Ensure the following prerequisites are met before proceeding with the configuration:

  • A Linear account with Administrator access.
  • A valid personal API key (API token).

Required Permissions

The API key must have the following minimum permissions to successfully aggregate users and teams:

User Role

The user generating the API key should have Admin privileges in Linear. While a standard Member can generate a key, Admin access ensures the connector can retrieve all users and teams (including private ones) across the workspace without visibility restrictions.

API Scopes

The minimum required scope is:

  • read - Read access for the user's account and workspace data

Personal API Key Permissions

When generating a Personal API Key, select the following access level:

  • Read - Grants read-only access to workspace data

API Authentication

The connector uses API token authentication to authorize API requests.

To generate an API token

  1. Sign in to your Linear account.
  2. Go to Settings > Account > API.
  3. Create a new Personal API Key.
  4. Select the Read permission scope.
  5. Copy the generated key. You’ll need it to configure the connector.

Resource Link

API and Webhooks - Linear Docs

Note

The linked document is not maintained by SailPoint and is subject to change without notice.