⚙️ Github webhook-based n8n workflow import template

⚡ 1,626 views · ⚙️ DevOps & CI/CD

💡 Pro Tip — If you need GitHub data beyond what the REST API gives you, ScraperNode has a repository scraper that extracts metadata at scale without token rate limits.

View All Scrapers

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.

  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:

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

🔗 Nodes Used

GitHub, Webhook, Read/Write Files from Disk

📥 Import

Download workflow.json and import into n8n: Workflow menu → Import from File

📖 Importing guide · 🔑 Credential setup