LinearEnhanced icon

LinearEnhanced

Consume Linear API
Join our community

Actions5

Overview

This node allows you to create a new issue in Linear, a popular project management and issue tracking tool. It is designed for use cases where you want to automate the creation of issues from n8n workflows, such as when receiving bug reports, feature requests, or tasks from other systems (e.g., forms, emails, or monitoring alerts). For example, you could automatically create a Linear issue whenever a new support ticket is received or when an error is detected in your application.

Properties

Name Meaning
Authentication Select the authentication method. Only "API Token" is supported.
Team Name or ID The team in Linear where the issue will be created. You can choose from a list or specify an ID using an expression. This field is required.
Title The title of the issue to be created. This field is required.
Additional Fields Optional fields to further define the issue:
└ Assignee Name or ID Assign the issue to a user by selecting from a list or specifying an ID using an expression.
└ Description A detailed description of the issue.
└ Due Date The due date for the issue.
└ Priority Set the priority of the issue. Options: Urgent, High, Normal, Low, No Priority.
└ State Name or ID Set the workflow state of the issue by choosing from a list or specifying an ID using an expression.

Output

The output is a JSON object representing the newly created Linear issue. The structure typically includes fields such as:

{
  "id": "string",
  "title": "string",
  "description": "string",
  "assignee": { "id": "string", "name": "string" },
  "team": { "id": "string", "name": "string" },
  "priority": "number",
  "state": { "id": "string", "name": "string" },
  "dueDate": "string",
  ...
}
  • All relevant details about the created issue are included.
  • If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message.

Dependencies

  • External Service: Requires access to the Linear API.
  • API Key: You must provide a valid Linear API token via n8n credentials (linearEnhancedApi).
  • n8n Configuration: No special configuration beyond setting up the credential.

Troubleshooting

Common Issues:

  • Invalid API Token: If the provided API token is invalid, you may see an error like "The security token included in the request is invalid." Ensure your API token is correct and has sufficient permissions.
  • Missing Required Fields: If required fields such as "Team Name or ID" or "Title" are missing, the node will throw an error. Make sure all required properties are set.
  • Incorrect IDs: Supplying incorrect team, assignee, or state IDs will result in errors from the Linear API. Use the dropdowns or verify IDs before use.

Error Handling:

  • If "Continue On Fail" is enabled, errors for individual items will be returned in the output under an error property, allowing the workflow to proceed for other items.

Links and References

Discussion