> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hightouch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

> Enrich and create tickets in Linear

## Overview

Linear is a popular issue-tracking tool designed for high-performance teams. It helps streamline workflows for software projects, sprints, and tasks.

Hightouch's Linear destination allows you to sync data from your warehouse to create and update issues in Linear. This can be useful for automating bug reports, feature requests, and other tasks based on events or data in your own systems.

## Supported Syncing

| Type | Description | Supported Sync Modes |
| - | - | - |
| **Issues** | Sync data from any source to Linear issues. | Upsert, Update, Insert, Delete |

For more information about sync modes, refer to the [sync modes](https://docs.hightouch.com/syncs/types-and-modes.md#sync-modes) docs.

## Connect to Linear

Go to the [**Destinations** overview page](https://app.hightouch.com/destinations?from=docs) and click the **Add destination** button. Select **Linear** and click **Continue**. You can then authenticate Hightouch to **Linear** by providing your API Key.

To get your API Key:

1. Log in to your Linear account.
2. Navigate to **Settings** > **Security & access**.
3. Under **Personal API keys**, create a new key.
4. Copy the key and paste it into the Hightouch configuration.

## Sync Configuration

Once you've set up your **Linear** destination and have a [model](https://docs.hightouch.com/getting-started/concepts.md#models) to pull data from, you can set up your sync configuration to begin syncing data. Go to the [**Syncs** overview page](https://app.hightouch.com/syncs?from=docs) and click the **Add sync** button to begin. Then, select the relevant model and the Linear destination you want to sync to.

### Syncing Issues

Hightouch allows you to create, update, or delete issues in Linear based on your model data.

#### Record Matching

You can match rows from your model to issues in Linear using the **Issue ID**. **Issue ID** must be a UUIDv4.

Refer to the [record matching docs](https://docs.hightouch.com/syncs/record-matching.md) for more information.

> [!NOTE]
>
> In **Insert** mode, Linear automatically generates an identifier for every new
> record synced if one is missing.

#### Field Mapping

You can map data from any of your model columns to Linear issue fields. Hightouch only requires you to map the **Title** field.

These are the additional fields you can map:

* Description
* Priority
* Assignee ID
* Project ID
* State ID
* Label IDs
* Due Date
* Estimate

#### Delete Behavior

The [delete behavior](https://docs.hightouch.com/syncs/overview.md#delete-behavior) you select dictates what to do when a row no longer appears in your model's query results. You have the following options:

| Behavior | Description |
| - | - |
| **Do nothing** | Keep the issue in Linear with all its synced fields |
| **Delete** | Delete the synced issues from Linear |

## Tips and troubleshooting

To see the exact API requests and responses from each sync run, use the [live debugger](https://docs.hightouch.com/syncs/debugger.md). To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up [sync alerts](https://docs.hightouch.com/syncs/alerting.md). If you run into an issue this page doesn't cover, [contact support](#pylon-chat).