Connect Jira to n8n?
Yes, you can connect Jira to n8n by creating a Jira API token, running n8n with Docker, and adding the Jira credentials to the Jira node. This guide shows a clear, step-by-step setup for beginners using Docker and Node.js so you can automate Jira tasks quickly.
What You Need
- A Jira Cloud account with permission to create API tokens.
- A machine with Docker installed.
- Basic familiarity with the n8n web editor.
How to Connect Jira to n8n using Docker
This section shows commands and logic. Follow each step in order. Each step has numbered actions.
Step 1: Install and run n8n with Docker
Start n8n using Docker. This runs a local instance on port 5678.
docker run -it --rm \
-p 5678:5678 \
-v ~/.n8n:/home/node/.n8n \
n8nio/n8n
Or use docker-compose for a persistent setup.
version: '3.1'
services:
n8n:
image: n8nio/n8n
ports:
- "5678:5678"
volumes:
- ~/.n8n:/home/node/.n8n
environment:
- N8N_BASIC_AUTH_ACTIVE=true
- N8N_BASIC_AUTH_USER=user
- N8N_BASIC_AUTH_PASSWORD=pass
Step 2: Create a Jira API token
Log in to your Atlassian account. Create an API token for n8n. Copy the token to a safe place.
- Go to https://id.atlassian.com/manage/api-tokens
- Click Create API token and name it “n8n”
- Copy the token value. You will not see it again.
Step 3: Add Jira credentials in n8n
Open the n8n editor at http://localhost:5678. Create new credentials for Jira.
- Click Credentials > New Credential > Jira.
- Enter your Atlassian email and paste the API token as the password.
- Save the credential and give it a clear name like “Jira Cloud – n8n”.
Step 4: Build a simple Jira workflow
Create a workflow that triggers and uses the Jira node.
- Add a Webhook trigger or Schedule trigger.
- Add the Jira node. Choose the saved credentials.
- Select an operation like Create Issue or Get Issue.
- Map fields and save the workflow.
# Example: test webhook via curl
curl -X POST http://localhost:5678/webhook-test -d '{"summary":"Test from n8n","description":"Created by curl"}'
# Then the Webhook trigger will start the workflow and the Jira node will create the issue.
Step 5: Test the connection
Run the workflow trigger. Watch the execution logs in the n8n editor. Confirm the issue appears in Jira.
- Trigger the webhook or run the workflow manually.
- Check the n8n execution details for success.
- Confirm the new issue in your Jira project.
Update
Keep n8n and the Docker image updated. Pull the latest image periodically.
docker pull n8nio/n8n
docker-compose pull && docker-compose up -d
Update steps ensure bug fixes and new node support.
Security
Store API tokens securely. Use environment variables or a secrets manager in production. Do not hard-code credentials in workflows.
- Use HTTPS in production behind a reverse proxy.
- Enable n8n basic auth or OAuth for the editor.
- Restrict Jira API token scopes when possible.
Done
You now have n8n connected to Jira. You can automate issue creation, updates, and more. Expand workflows by adding filters, transformations, and error handling.