Github Webhook-Based n8n Workflow Import Template

Description

This n8n workflow template uses community nodes and is only compatible with the self-hosted version of n8n.

This template aims to ease the process of deploying workflows from github. It has a companion repository that developers might find useful{. See below for more details

How it works

Automatically import and deploy n8n workflows from your GitHub repository to your production n8n instance using a secured webhook-based approach. This template enables teams to maintain version control of their workflows while ensuring seamless deployment through a CI/CD pipeline.

Receives webhook notifications from GitHub when changes are pushed to your repository
Lists all files in the repository and filters for .json workflow files
Downloads each workflow file and saves it locally
Imports all workflows into n8n using the CLI import command
Cleans up temporary files after successful import

To trigger the deployment, send a POST request to your webhook with the set up credentials (basic auth) with the following body:
{
"owner": "GITHUB_REPO_OWNER_NAME",
"repository": "GITHUB_REPOSITORY_NAME"
}

Set up steps
Once importing this template in n8n :
Setup the webhook basic auth credentials
Setup the github credentials
Activate the workflow !

Companion repository
There is a companion repository located at https://github.com/dynamicNerdsSolutions/n8n-git-flow-template that has a Github action already setup to work with this workflow.

It provides a complete development environment with:
Local n8n instance via Docker
Automated workflow export and commit scripts
Version control integration
CI/CD pipeline setup

This setup allows teams to maintain a clean separation between development and production environments while ensuring reliable workflow deployment.