How to Route GitHub Bug Reports to Jira with N8n

Dashboard > New workflow

Create New Workflow

Start a new N8n workflow to handle the GitHub-to-Jira integration. This workflow will run whenever a GitHub issue receives a bug label.

1. 1Click 'New workflow' from the N8n dashboard
2. 2Click the '+' button to add your first node
3. 3Name your workflow 'GitHub Bug Router'

Node Library > Triggers > GitHub Trigger

Add GitHub Webhook Trigger

Configure N8n to listen for GitHub issue events. The webhook will fire whenever an issue is labeled, unlabeled, or modified.

1. 1Click the '+' button and search for 'GitHub Trigger'
2. 2Select 'GitHub Trigger' from the list
3. 3Choose 'Issues' as the event type
4. 4Set 'Events' to 'labeled'

GitHub Trigger > Credentials > Create New

Connect GitHub Repository

Link your GitHub account and specify which repository to monitor. You'll need a GitHub personal access token with repo permissions.

1. 1Click 'Create New' next to Credentials
2. 2Enter your GitHub personal access token
3. 3Select your target repository from the dropdown
4. 4Click 'Save' to store the credential

Node Library > Logic > IF

Add Bug Label Filter

Filter the webhook to only process issues labeled with 'bug'. This prevents non-bug issues from creating Jira tickets.

1. 1Add an 'IF' node after the GitHub trigger
2. 2Set condition to 'String' comparison
3. 3Set Value 1 to '{{ $json.label.name }}'
4. 4Set Operation to 'equal' and Value 2 to 'bug'

Node Library > Data > Code

Map Severity from Labels

Extract severity information from GitHub labels to set the appropriate Jira priority. This code node checks for severity labels like 'critical', 'high', 'medium', 'low'.

1. 1Add a 'Code' node after the IF 'true' branch
2. 2Set the code language to JavaScript
3. 3Add logic to check issue labels for severity keywords
4. 4Map severity to Jira priority values (1-5 scale)

Node Library > Apps > Jira

Add Jira Node

Configure the Jira integration to create new bug tickets. This node will receive the GitHub issue data and create a corresponding Jira issue.

1. 1Add a 'Jira' node after the Code node
2. 2Select 'Issue' as the resource
3. 3Choose 'Create' as the operation
4. 4Set 'Issue Type' to 'Bug'

Jira > Credentials > Create New

Configure Jira Credentials

Connect to your Jira instance using either basic auth or API token. You'll need your Jira domain and user credentials.

1. 1Click 'Create New' next to Jira Credentials
2. 2Enter your Jira domain (without https://)
3. 3Add your email and API token
4. 4Test the connection and save

Jira Node > Project Configuration

Select Target Project

Choose which Jira project should receive the bug reports. The project must have Bug issue type enabled.

1. 1Select your target project from the Project dropdown
2. 2Verify 'Bug' appears in the Issue Type field
3. 3Set the default assignee if required by your project

Jira Node > Field Mapping

Map Issue Fields

Connect GitHub issue data to Jira fields. This includes title, description, priority, and any custom fields your project requires.

1. 1Set Summary to '{{ $node.GitHub_Trigger.json.issue.title }}'
2. 2Map Description to '{{ $node.GitHub_Trigger.json.issue.body }}'
3. 3Set Priority to '{{ $node.Code.json.priority }}'
4. 4Add Reporter as the GitHub issue author

Jira Node > Description Field

Add GitHub Link

Include a link back to the original GitHub issue in the Jira ticket description. This helps developers jump between systems.

1. 1Modify the Description field mapping
2. 2Add GitHub issue URL at the bottom
3. 3Use '{{ $node.GitHub_Trigger.json.issue.html_url }}' expression
4. 4Format with 'GitHub Issue: [URL]' label

Workflow > Execute Workflow

Test the Workflow

Run a test to verify the integration works correctly. You'll manually trigger with sample GitHub data.

1. 1Click 'Execute Workflow' button
2. 2Choose 'Manual' execution
3. 3Provide sample GitHub issue data with bug label
4. 4Check that Jira ticket gets created

Workflow Header > Active Toggle

Activate Workflow

Enable the workflow to run automatically on GitHub events. Copy the webhook URL to GitHub repository settings.

1. 1Click 'Active' toggle in the top right
2. 2Copy the webhook URL from GitHub Trigger node
3. 3Go to GitHub repo Settings > Webhooks
4. 4Add the N8n webhook URL with 'application/json' content type

Drop this into an n8n Code node.

// Enhanced severity detection in Code node
const labels = $input.first().json.issue.labels.map(l => l.name.toLowerCase());
let priority = 3; // default medium

// Enhanced severity detection in Code node
const labels = $input.first().json.issue.labels.map(l => l.name.toLowerCase());
let priority = 3; // default medium
if (labels.some(l => l.includes('critical') || l.includes('p0'))) priority = 1;
else if (labels.some(l => l.includes('high') || l.includes('p1'))) priority = 2;
else if (labels.some(l => l.includes('low') || l.includes('p3'))) priority = 4;
return [{json: {priority, severity_labels: labels}}];