Linear Issue to n8n Node
Purpose
Turn a Linear issue URL into a new n8n node task by:
- •Using the issue key for the git branch name
- •Using the final URL path segment as the API title
- •Building the node from the ChannelTalk swagger spec
Inputs
- •Linear issue URL (example):
- •
https://linear.app/channel/issue/FDE-1982/n8n-user-post-openv5usersuseridtouch
- •
Extraction Rules
- •Issue key: the segment right after
/issue/(e.g.,FDE-1982). - •API title: the last path segment of the URL (e.g.,
n8n-user-post-openv5usersuseridtouch).
Workflow
- •
Create a branch from
origin/main:- •Run:
- •
git fetch origin - •
git checkout -b <ISSUE_KEY> origin/main
- •
- •Run:
- •
Find the API spec in the swagger file:
- •Use
ref/channel-swagger.jsonto locate the endpoint that matches the API title.
- •Use
- •
Create the n8n node:
- •Use the swagger spec as the source of truth for parameters, method, and path.
- •Use existing node files as references:
- •
nodes/ChannelTalk/resources/message/ - •
nodes/ChannelTalk/ChannelTalk.node.ts
- •
- •Mirror existing patterns for:
- •request/response structure
- •required/optional fields
- •parameter mapping
- •resource registration in the main node file
Output Expectations
- •A new resource implementation under
nodes/ChannelTalk/resources/ - •Updated
ChannelTalk.node.ts(and any index files) to register the new operation - •Consistent with existing ChannelTalk node conventions
Notes
- •Always base the branch on
origin/main. - •The API title comes only from the last path segment of the Linear URL.