---
title: "Linear"
canonical_url: "https://docs.getdx.com/connectors/linear/"
md_url: "https://docs.getdx.com/connectors/linear.md"
last_updated: "2026-06-08"
---

# Linear
By integrating Linear with DX, you can analyze issue data, cycle time metrics, and projects. Please refer to the API documentation below and our [schema explorer](https://docs.getdx.com/schema/) to see what data DX imports.

## Prerequisites

To connect Linear to DX, you need:

- an Linear service account
- a [personal API key](https://linear.app/docs/security-and-access)

## Setup instructions


> This connector supports multiple credentials. You can add additional credentials to distribute API requests across multiple tokens, improving import speed and reliability. To learn more, go to [Can I use multiple API credentials for a data connector?](https://docs.getdx.com/knowledgebase/can-i-use-multiple-api-credentials-for-a-data-connector/)


Follow the steps below to connect Linear to DX.

#### Step 1

Create an Linear service account to be used for DX, and ensure that the service account is granted access to the projects that you want to import into DX.

#### Step 2

Once signed in to the service account, browse to account settings and generate a new Personal API key.

![](https://docs.getdx.com/assets/images/connectors/linear/api-key.png){class="max-w-xl mx-auto"}

#### Step 3

- Navigate to the connections page in DX and select "+ Connection" in the top right.
- Enter the credentials you have generated in the previous steps—refer to the information below for errors and troubleshooting.

## API reference

The table below lists the specific API endpoints that are used by DX.


| Operation Name | Type | Documentation |
|------------------|--------|---------------|
| teams | Query | [Link](https://studio.apollographql.com/public/Linear-API/variant/current/schema/reference/objects/Team) |
| projects | Query | [Link](https://studio.apollographql.com/public/Linear-API/variant/current/schema/reference?query=projects#projects) |
| issueLabels | Query | [Link](https://studio.apollographql.com/public/Linear-API/variant/current/schema/reference?query=labels#issueLabels) |
| workflowStates | Query | [Link](https://studio.apollographql.com/public/Linear-API/variant/current/schema/reference?query=workflow#workflowStates) |
| issues | Query | [Link](https://studio.apollographql.com/public/Linear-API/variant/current/schema/reference?query=issues#issues) |
| users | Query | [Link](https://studio.apollographql.com/public/Linear-API/variant/current/schema/reference?query=user#users) |


## Errors

The table below lists potential error codes when adding a connection in DX.


| Error | Description |
|----------------------|------------------------------------------------------------------------------------------------------------------|
| `invalid_credentials` | Your API credentials entered are not valid. |
| `invalid_permissions` | Your API token does not have the permissions required by DX. |
| `no_resources` | Your service account does not have access to any projects. |


## Data Cloud API

Once the initial connection is created successfully, Linear credentials can be managed via the Data Cloud API.

- [credentials.create](https://docs.getdx.com/datacloudapi/methods/credentials.create/)
- [credentials.update](https://docs.getdx.com/datacloudapi/methods/credentials.update/)
- [credentials.info](https://docs.getdx.com/datacloudapi/methods/credentials.info/)
- [credentials.list](https://docs.getdx.com/datacloudapi/methods/credentials.list/)
- [credentials.delete](https://docs.getdx.com/datacloudapi/methods/credentials.delete/)

### Credential fields


| Field | Type | Description |
| ----- | ---- | ----------- |
| `secrets.api_token` | `String` | A Linear personal API key. |


```json
{
  "id": 456,
  "secrets": {
    "api_token": "lin_api_xxxxxxxxxxxxxxxxxxxx"
  }
}
```
---

## Sitemap

[Overview of all docs pages](/llms.txt)