Linear AdvancedInstall

Overview

This node enables creating comments on issues within the Linear project management platform. It is useful for automating communication and collaboration workflows by programmatically adding markdown-formatted comments to specific issues. For example, you can use this node to automatically add status updates, feedback, or notes to an issue when triggered by other events in your workflow.

Properties

Output

The output contains a JSON object representing the created comment as returned by the Linear API. This typically includes details such as the comment's ID, body content, author information, timestamps, and related issue metadata. There is no binary data output.

Example output structure (simplified):

{
  "id": "comment_id",
  "body": "Markdown formatted comment text",
  "createdAt": "timestamp",
  "updatedAt": "timestamp",
  "creator": {
    "id": "user_id",
    "name": "User Name"
  },
  "issueId": "issue_id"
}

Dependencies

• Requires an active connection to the Linear API via an API key credential.
• The node uses the official Linear SDK (@linear/sdk) to interact with the API.
• Proper configuration of the Linear API credentials in n8n is necessary.

Troubleshooting

• Operation Not Available: The source code explicitly throws an error if trying to use the addComment operation under the issue resource or the comment resource operations other than create/get/update. Make sure to use the correct resource and operation combination.
• Missing Required Fields: Ensure that the Issue ID and Body fields are provided; otherwise, the API call will fail.
• API Authentication Errors: Verify that the API key credential is correctly set up and has sufficient permissions.
• Invalid Markdown: While the body supports markdown, invalid formatting might cause unexpected rendering in Linear but won't cause node errors.

Links and References

• Linear API Documentation
• Linear SDK on npm