Linear Actions & Triggers in Workflows

Linear is the issue tracker engineering and product teams use to plan, ship, and report on work. This integration brings it directly into the Workflow Builder, so that automations can react to engineering events and vice versa. Let’s learn how to use them!

Integrating Linear

First, head to the Integration section inside your account settings and click “connect” under Linear.

Authenticate via OAuth and authorize the workspace.

Using Linear In Workflows

Once connected, you can start integrating Linear into automations by heading to the Workflows tab, and creating or editing a workflow.

Linear Triggers

All triggers are Instant, powered by Linear webhooks, and fire within seconds of the underlying change. Your options are:

1. New Issue: Fires when a new issue is created. Filterable by team.
2. Updated Issue: Fires when an issue’s status, priority, assignee, labels, or other fields change.
3. New Issue Comment: Fires when a new comment is added to any issue.
4. New Project: Fires when a new project is created in Linear.
5. New Project Update: Fires when a project update is posted (with health status).
6. Updated Project Update: Fires when an existing project update is edited.

1. New Customer: Fires when a new customer record is created in Linear.
2. Updated Customer: Fires when an existing customer record is edited.
3. New Customer Need: Fires when a new customer need (feature request) is captured.
4. Updated Customer Need: Fires when a customer’s need status, priority, or linked work changes.
5. New Document Comment: Fires when a new comment is added to a Linear document (PRD, spec, proposal).
6. New Initiative Update: Fires when an update is posted on a Linear initiative.

When using a Linear trigger, you must select a Team to monitor.

Once selected, you can add other filters as desired.

Linear Actions

Linear Actions will update your Linear database whenever the automation is triggered. The available actions are:

1. Create Issue: Creates a new issue in Linear with title, description, team, project, priority, assignee, labels, and due date.
2. Update Issue: Updates fields on an existing issue. Only fields explicitly set are sent.
3. Get Issue: Fetches the latest state of a single issue by ID.
4. Find Issues: Searches Linear issues by team, project, label, status, assignee or text.
5. Create Comment: Adds a comment (markdown supported) to an existing issue.
6. Create Issue Attachment: Attaches a URL to an issue with two-way linking back to the source record.

1. Add Label To Issue: Adds a label to an existing issue.
2. Remove Label From Issue: Removes a label from an existing issue.
3. Create Project: Creates a new Linear project with a name, description, lead, and target date.
4. Find Project: Looks up a Linear project by name or filter.
5. Create Customer: Creates a customer record in Linear (name, domain, tier, revenue).
6. Find Customer: Finds a Linear customer by name or domain.
7. Create Customer Need: Creates a customer need linked to a customer record; can be linked to an issue or project.

Fill out the required and optional fields.

Always test before publishing. Testing locks the payload schema and gives downstream steps a real record to map against.

Once connected, you can enjoy the connection and easy automation. This integration allows for native connection with Linear, with two-way linking and a closed-loop feedback that helps you capture bugs, manage feature requests, and improve your responsiveness, with no long-lived API tokens to manage, immediate sync, and increased visibility. We hope you enjoy it!