Configuration
| Option | Required | Description |
|---|---|---|
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected Linear account to use for this step. |
| Action | Yes | The Linear action to perform (Create Issue, List Issues, Update Issue, List Teams). |
| Arguments | Yes | Per-action form fields generated from the action’s schema. Each text field has an Insert Variable button for injecting {{placeholder}} values. A Raw JSON tab is available for advanced usage. |
| When the step fails | No | Controls whether the workflow should Terminate Workflow or Continue if this step fails. |
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
| Field type | How it renders | Insert Variable available |
|---|---|---|
| Text / number | Plain input. | Create Issue and Update Issue only |
| Boolean | Toggle switch (label on the left, switch on the right). | No |
Team (team_id) | Dropdown populated from your connected Linear workspace — select your team by name. | No |
Project (project_id) | Dropdown populated from your connected Linear workspace — select your project by name. | No |
Issue (issue_id) | Dropdown populated from your connected Linear workspace — select an issue by title. | No |
| Label IDs / string arrays | List of text inputs. The Add button appears next to the array label. | No (array items do not support variable insertion) |
{{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
| Action | Description |
|---|---|
| Create Issue | Create a new issue in a specified team. |
| List Issues | Search or list issues with optional filters. |
| Update Issue | Modify an existing issue by ID. |
| List Teams | List all teams in the connected Linear workspace. |
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:Example
- Open Integrations and connect Linear if you have not already done that.
- Add a Linear step to your workflow.
- Select a connected account in Authentication.
- Choose Create Issue in Action.
- 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. - 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.