Skip to main content
Use Linear when you want a workflow step to create issues, list issues, update issues, or retrieve team information from a connected Linear workspace.

​
Configuration

Before you configure this step, connect Linear in Integrations for your workspace. If no active Linear connection is available, the step shows a warning with a link to Integrations instead of the account selector.

​
Arguments form

When you select an action, the Arguments section automatically renders a form driven by the action’s input schema — no manual JSON editing required. Each field includes:
  • A label and description from the action’s schema.
  • An Insert Variable button next to the label that injects references like {{step_1.output.id}} at the cursor position.
  • Validation feedback inline if a required field is left empty.

​
Field types

All dropdown options are fetched in a single request when you select a connected account, so opening the settings panel does not trigger multiple API calls. If the lookup fails for a specific field, it falls back to a plain text input so you can still enter a value manually or use a {{variable}}. Switch to the Raw JSON tab for power users or when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

​
Actions

​
Output

This step stores the Linear API response as the step output. The shape of the response depends on the action. Use the full output reference in later steps:
For example, after a Create Issue step you might reference the new issue’s ID:

​
Example

  1. Open Integrations and connect Linear if you have not already done that.
  2. Add a Linear step to your workflow.
  3. Select a connected account in Authentication.
  4. Choose Create Issue in Action.
  5. In the Arguments form, use the Team dropdown (auto-populated from your Linear account) to select a team, fill in Title and optionally Description. Use Insert Variable next to any field label to reference an earlier step’s output — for example, {{step_1.output}} as the issue title.
  6. Click Run in the step header to test the action, then review the returned payload in Output.

​
Notes

  • This step depends on a connected Linear integration in your workspace.
  • The Raw JSON tab in Arguments is always available if you prefer to write JSON directly.
  • The Team, Project, and Issue fields show dropdowns populated from your connected Linear workspace. If no options load, check that the integration is active in Integrations.
  • The Update Issue action provides an Issue dropdown so you can select an existing issue by title rather than entering an ID manually.

​
Using Linear as an Agent Tool

You can also add Linear as a tool in the Agent Editor. Open the agent, click Add tool, and select Linear. In the tool settings panel, choose the connected Linear account the agent should use. The agent will create, search, and update issues automatically during conversations when relevant. See also: Integrations, Creating and Editing, and Testing and Iteration