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 docs.
Connect to Linear
Go to the Destinations overview page 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:
- Log in to your Linear account.
- Navigate to Settings > Security & access.
- Under Personal API keys, create a new key.
- Copy the key and paste it into the Hightouch configuration.
Sync Configuration
Once you've set up your Linear destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page 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 for more information.
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 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
Common errors
To date, our customers haven't experienced any errors while using this destination. If you run into any issues, please don't hesitate to . We're here to help.
Live debugger
Hightouch provides complete visibility into the API calls made during each of your sync runs. We recommend reading our article on debugging tips and tricks to learn more.
Sync alerts
Hightouch can alert you of sync issues via Slack, PagerDuty, SMS, or email. For details, please visit our article on alerting.