GitHub est la plateforme de référence pour héberger du code, gérer des versions et collaborer sur des projets. En connectant GitHub à N8N, vous pouvez automatiser la création de fichiers, le suivi de commits, la gestion d’issues ou encore le versioning de vos workflows. La clé de cette intégration : configurer une application OAuth dans GitHub et récupérer les credentials pour les utiliser dans N8N.
Qu’est-ce que l’intégration GitHub dans N8N ?
L’intégration GitHub dans N8N permet à vos workflows d’interagir directement avec vos dépôts GitHub. Contrairement à une utilisation manuelle de l’interface web GitHub, cette connexion automatise les opérations : création de fichiers, commits, gestion de branches, ouverture d’issues ou déclenchement d’actions sur événements.
N8N propose deux types de nœuds GitHub : les triggers qui détectent des événements (nouveau commit, pull request, issue créée) et les actions qui exécutent des opérations (créer un fichier, lister les repositories, modifier une issue). L’authentification repose sur le protocole OAuth 2.0, ce qui nécessite de créer une application OAuth dans les paramètres développeur de GitHub.
Prérequis : compte GitHub et accès N8N
Avant de configurer la connexion, vous devez disposer d’un compte GitHub actif et d’une instance N8N fonctionnelle (cloud ou auto-hébergée). La procédure est identique dans les deux cas, seule l’URL de callback change selon votre configuration.
Ce dont vous avez besoin
- Un compte GitHub : créez-en un gratuitement sur github.com si ce n’est pas déjà fait.
- Un repository de test : créez un dépôt simple pour valider la connexion avant de l’utiliser en production.
- Une instance N8N : cloud (n8n.io) ou auto-hébergée, avec accès aux credentials.
- L’URL de callback OAuth : fournie par N8N lors de la création du credential GitHub.
Créer une application OAuth dans GitHub
L’authentification entre N8N et GitHub repose sur OAuth 2.0. Vous devez créer une application OAuth dans les paramètres développeur de GitHub pour obtenir le Client ID et le Client Secret nécessaires à la connexion.
Étape 1 : Accéder aux paramètres développeur
Connectez-vous à GitHub, cliquez sur votre avatar en haut à droite, puis sélectionnez Settings. Descendez tout en bas du menu latéral et cliquez sur Developer settings. Dans le menu de gauche, sélectionnez OAuth Apps, puis cliquez sur New OAuth App.
Étape 2 : Configurer l’application OAuth
Remplissez les champs requis pour créer votre application :
- Application name : donnez un nom explicite, par exemple « N8N Integration » ou « N8N Test ».
- Homepage URL : renseignez l’URL de votre site ou de votre instance N8N (champ obligatoire mais non critique pour le fonctionnement).
- Authorization callback URL : collez l’URL de callback fournie par N8N dans la fenêtre de création du credential (cette URL est cruciale pour l’authentification).
Laissez « Enable Device Flow » décoché, puis cliquez sur Register application.
Étape 3 : Récupérer le Client ID et le Client Secret
Une fois l’application créée, GitHub affiche votre Client ID. Copiez-le. Juste en dessous, cliquez sur Generate a new client secret pour obtenir le Client Secret. Copiez-le immédiatement : il ne sera plus visible après avoir quitté la page. Ces deux informations seront à renseigner dans N8N.
Configurer le credential GitHub dans N8N
Une fois votre application OAuth créée dans GitHub, vous pouvez configurer le credential dans N8N. Cette étape établit la connexion sécurisée entre vos workflows et vos dépôts GitHub.
Étape 1 : Créer le credential
Depuis la page d’accueil de N8N, cliquez sur Credentials dans le menu latéral. Cliquez sur Create Credential et recherchez « GitHub OAuth2 API ». Sélectionnez-le pour ouvrir le formulaire de configuration.
Étape 2 : Renseigner les informations OAuth
Le formulaire affiche trois éléments clés :
- OAuth Redirect URL : c’est l’URL que vous avez copiée dans GitHub lors de la création de l’application OAuth. Elle est générée automatiquement par N8N.
- Client ID : collez le Client ID récupéré depuis GitHub.
- Client Secret : collez le Client Secret généré dans GitHub.
Conseil pratique : renommez votre credential avec un nom explicite (exemple : « GitHub – Production » ou « GitHub – Ocade ») pour le retrouver facilement si vous gérez plusieurs connexions.
Étape 3 : Autoriser la connexion
Cliquez sur le bouton Connect en bas du formulaire. Une fenêtre GitHub s’ouvre et vous demande d’autoriser l’accès. Si vous appartenez à des organisations GitHub, vous pouvez également leur accorder l’accès en cliquant sur Grant à côté de chaque organisation concernée. Cliquez sur Authorize pour finaliser la connexion. Un message « Connection successful » confirme que N8N est désormais connecté à GitHub.
Créer un workflow pour tester la connexion
Maintenant que votre credential est configuré, vous pouvez créer un workflow de test pour valider la connexion. L’objectif : créer un fichier dans votre repository GitHub directement depuis N8N.
Étape 1 : Ajouter le nœud GitHub
Créez un nouveau workflow dans N8N. Ajoutez un nœud en recherchant « GitHub » et sélectionnez le nœud d’actions (pas le trigger). Choisissez l’opération Create File qui permet de créer un fichier dans un repository.
Étape 2 : Configurer le nœud
Sélectionnez le credential GitHub que vous venez de créer. Renseignez ensuite les paramètres requis :
- Repository Owner : votre nom d’utilisateur GitHub ou le nom de votre organisation (visible dans l’URL de votre repository).
- Repository Name : le nom du repository de test que vous avez créé (exemple : « n8n-test »).
- File Path : le chemin et nom du fichier à créer (exemple : « test.txt » pour un fichier à la racine).
- File Content : le contenu du fichier (exemple : « Contenu créé depuis N8N »).
- Commit Message : le message de commit associé (exemple : « Création de fichier via N8N »).
Étape 3 : Exécuter et vérifier
Cliquez sur Execute step pour lancer le nœud. Si tout est correctement configuré, vous obtenez un message de succès avec les détails du fichier créé. Retournez dans GitHub, rafraîchissez la page de votre repository : le fichier test.txt apparaît avec le contenu que vous avez défini.
Étape 4 : Vérifier le commit
Cliquez sur le fichier dans GitHub pour voir son contenu. Vous pouvez également consulter l’historique des commits pour retrouver votre message de commit. Cette traçabilité est essentielle pour suivre les modifications automatisées effectuées par vos workflows N8N.
Cas d’usage : versioning des workflows N8N
Au-delà de la création de fichiers, l’intégration GitHub ouvre des possibilités stratégiques pour la gestion de vos automatisations. Le cas d’usage le plus pertinent : sauvegarder automatiquement vos workflows N8N dans un repository GitHub pour conserver un historique complet des versions.
Le problème des historiques limités
Dans N8N Cloud, vous disposez d’historiques illimités, mais c’est une fonctionnalité payante. En version auto-hébergée, l’historique des modifications de workflow est limité à une journée par défaut. Si vous devez revenir à une version d’il y a cinq jours, c’est impossible sans sauvegarde externe.
La solution : commit automatique sur GitHub
En créant un workflow qui exporte le JSON de vos workflows et le commit sur GitHub à chaque publication, vous obtenez un versioning complet et gratuit. Chaque modification est tracée avec son message de commit, et vous pouvez restaurer n’importe quelle version en récupérant le JSON correspondant dans l’historique GitHub.
Autres cas d’usage concrets
- Déploiement automatisé : déclenchez un workflow N8N lorsqu’un push est effectué sur une branche spécifique pour lancer des tests ou des déploiements.
- Gestion d’issues : créez automatiquement des tickets GitHub lorsqu’un formulaire est soumis ou qu’une erreur est détectée dans vos systèmes.
- Synchronisation de documentation : mettez à jour des fichiers Markdown dans un repository à partir de données issues d’un CMS ou d’une base de données.
- Backup de configurations : sauvegardez régulièrement des fichiers de configuration ou des exports de données dans un repository privé.
Comment connecter GitHub à N8N pour automatiser la gestion de vos repositories ?
Conclusion
Connecter GitHub à N8N ouvre un champ d’automatisations puissant pour les développeurs et les équipes techniques : versioning de workflows, déploiement automatisé, gestion d’issues, synchronisation de documentation. La procédure repose sur la création d’une application OAuth dans GitHub, la récupération du Client ID et du Client Secret, puis la configuration du credential dans N8N.
Le point clé à retenir : l’URL de callback OAuth doit correspondre exactement entre GitHub et N8N. Sans cette cohérence, l’authentification échouera. Une fois la connexion établie, testez-la immédiatement avec un workflow simple avant de l’utiliser en production.
Pour aller plus loin, explorez nos autres ressources N8N ou contactez notre équipe pour concevoir des automatisations GitHub adaptées à vos besoins métier.
Connectez-vous à GitHub, allez dans Settings > Developer settings > OAuth Apps > New OAuth App. Renseignez un nom d’application, une Homepage URL, et collez l’Authorization callback URL fournie par N8N. Cliquez sur Register application pour obtenir le Client ID, puis générez le Client Secret.
La cause la plus fréquente est une URL de callback incorrecte. Vérifiez que l’Authorization callback URL dans votre application OAuth GitHub correspond exactement à celle affichée dans N8N. Assurez-vous également que le Client ID et le Client Secret sont correctement copiés, sans espaces supplémentaires.
Lors de l’autorisation de la connexion OAuth, GitHub affiche la liste de vos organisations. Cliquez sur Grant à côté de chaque organisation que vous souhaitez rendre accessible depuis N8N. Sans cette autorisation explicite, vos workflows ne pourront pas accéder aux repositories de l’organisation.
Oui, c’est un cas d’usage stratégique. Créez un workflow qui exporte le JSON de vos workflows et le commit automatiquement sur un repository GitHub. Vous obtenez ainsi un historique complet de vos modifications, indépendant des limitations de l’historique N8N, avec la possibilité de restaurer n’importe quelle version.
N8N permet de créer des fichiers, gérer des commits, ouvrir ou modifier des issues, lister des repositories, gérer des branches et déclencher des workflows sur événements GitHub (push, pull request, nouvelle issue). Les triggers GitHub détectent les événements, les actions exécutent les opérations.
Non, Device Flow n’est pas nécessaire pour l’intégration N8N. Laissez cette option décochée lors de la création de votre application OAuth dans GitHub. N8N utilise le flux OAuth 2.0 standard avec redirection, qui ne requiert pas cette fonctionnalité.
