Github webhook-based n8n workflow import template

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.

1. Receives webhook notifications from GitHub when changes are pushed to your repository
2. Lists all files in the repository and filters for .json workflow files
3. Downloads each workflow file and saves it locally
4. Imports all workflows into n8n using the CLI import command
5. 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 :

1. Setup the webhook basic auth credentials
2. Setup the github credentials
3. 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.