flowtemplates

n8n · tutoriel · vérifié le 6 septembre 2026

Importer un modèle n8n

Un modèle n8n est un fichier JSON de workflow ordinaire, et deux chemins mènent à l’intérieur : copier le JSON puis le coller avec Ctrl+V (Cmd+V sur Mac) sur un canevas vide, ou ouvrir le menu à trois points en haut à droite et choisir « Import from File » ou « Import from URL ». Comptez moins d’une minute dans les deux cas.

Deux points à savoir avant de commencer. L’éditeur n8n est en anglais : le dépôt n8n ne contient qu’un fichier de langue, en.json, de sorte que les entrées de menu s’appellent « Download », « Import from File » et « Import from URL » même dans un navigateur en français. Et les avertissements d’identifiants qui apparaissent après l’import sont normaux : le modèle ne transporte que des valeurs de substitution.

La procédure en sept étapes

  1. Récupérer le JSON du workflowSur une page de modèle, cliquez sur Copy JSON ou téléchargez le fichier .json. Nos fichiers sont nettoyés : aucune clé réelle, aucun jeton, seulement des marqueurs comme {{YOUR_SLACK_CREDENTIAL}}.
  2. Ouvrir un workflow videDans Workflows, créez-en un nouveau. Importez toujours sur un canevas vide : l’import ajoute des nœuds au canevas courant, il ne le remplace pas.
  3. Coller ou importerCliquez sur le canevas puis Ctrl+V, ou passez par ⋯ → « Import from File ». n8n reconstruit tous les nœuds et leurs liaisons.
  4. Reconnecter vos identifiantsChaque nœud signalé s’ouvre sur un champ d’identifiants. Créez-en un ou sélectionnez un existant, puis authentifiez-vous avec votre propre compte.
  5. Ajuster les paramètresRenseignez ce qui vous est propre : l’identifiant d’une feuille de calcul, un canal Slack, un dossier, un chemin de webhook. Le tableau de chaque page de modèle indique exactement quoi remplir.
  6. Exécuter une foisAvec Execute Workflow, lancez un passage de test avec des données d’exemple et vérifiez que chaque nœud passe au vert.
  7. PublierC’est seulement à ce moment que n8n enregistre les webhooks de production et démarre les planifications. Si l’appel répond alors 404, voyez « webhook non enregistré ».

Ce que contient le fichier, et ce qu’il faut retirer avant de le partager

Le JSON décrit des nœuds, des paramètres et des connexions ; il ne contient pas les valeurs des identifiants. La documentation de n8n est cependant plus précise que la plupart des tutoriels : les fichiers exportés contiennent les noms et les identifiants techniques des credentials. Les identifiants ne présentent pas de risque, les noms peuvent en présenter selon vos conventions. n8n signale en outre que les nœuds HTTP Request importés depuis une commande cURL peuvent contenir des en-têtes d’authentification.

Conséquence pratique : relisez tout export personnel avant de le déposer sur un forum, un ticket ou un dépôt public. Notre validateur de JSON de workflow effectue exactement ce contrôle dans le navigateur — il cherche des motifs de clés et de jetons et liste les types d’identifiants référencés, sans envoyer le fichier où que ce soit.

Quand l’import échoue, c’est le message qui tranche

n8n emploie des phrases différentes pour des causes différentes. Lisez la vôtre avant de modifier quoi que ce soit.

  • « Could not import file » / « The file does not contain valid JSON data »Le fichier n’est pas du JSON valide. Presque toujours une virgule en trop ou des guillemets typographiques récupérés lors d’un copier-coller depuis une messagerie ou un document.
  • « The imported data does not contain valid workflow data (‘nodes’ and ‘connections’ are missing) »JSON valide, mauvaise forme. Typiquement un nœud isolé copié, ou une réponse d’API où le workflow est encore enveloppé dans un objet data.
  • « Skipped N node(s) with missing type »L’import a fonctionné, mais votre instance ne connaît pas ces types de nœuds : le plus souvent des nœuds communautaires à installer au préalable.
  • En ligne de commande : <code>SQLITE_CONSTRAINT: NOT NULL constraint failed: workflow_entity.id</code>Reproduit sur n8n 2.25.7 : n8n import:workflow exige un champ id de premier niveau, contrairement à l’éditeur. Ajoutez n’importe quelle chaîne unique comme "id".

Les huit messages — quatre dans l’éditeur, quatre en ligne de commande — avec leur cause et leur correctif sont détaillés sur « impossible d’importer le fichier ».

Importer en ligne de commande

Pour une instance auto-hébergée, n8n documente n8n import:workflow --input=fichier.json ainsi que --separate --input=dossier/ pour un répertoire entier. Par défaut, import:workflow désactive chaque workflow importé ; --activeState=fromJson conserve à la place le champ active de chaque fichier, une option que la documentation limite aux modes multi-main et file d’attente.

Deux différences avec l’éditeur. D’abord le champ id évoqué plus haut. Ensuite, plus prosaïquement : pour un seul workflow, coller va plus vite qu’ouvrir un terminal. Si l’instance reste à monter, tout est dans le guide n8n auto-hébergé.

Sources et date de vérification

Les noms de menu et les règles d’import proviennent de la documentation n8n, consultée le 6 septembre 2026 ; les erreurs en ligne de commande ont été reproduites le même jour sur n8n 2.25.7 sous Docker.

Questions fréquentes

Où se trouve « Import from File » dans n8n ?

Dans le menu à trois points (⋯) en haut à droite de l’éditeur de workflow. La documentation de n8n y place « Import from URL » et « Import from File » ; l’export se fait par le même menu avec « Download ». Vous pouvez aussi coller le JSON copié directement sur le canevas avec Ctrl+V ou Cmd+V.

Pourquoi des erreurs d’identifiants apparaissent-elles après l’import ?

Parce que c’est le comportement attendu. Les modèles ne transportent que des valeurs de substitution : n8n signale donc chaque nœud concerné jusqu’à ce que vous connectiez votre propre compte. Ouvrez les nœuds marqués et créez ou choisissez un identifiant. Ce n’est pas un import raté.

L’import écrase-t-il mes workflows existants ?

Non. L’import dépose les nœuds sur le canevas ouvert. Importez sur un workflow neuf et vide pour garder les choses séparées, sinon les nouveaux nœuds se placent à côté de ceux qui existaient déjà.

Peut-on coller sans risque le JSON d’un workflow trouvé ailleurs ?

Le fichier décrit des nœuds, des paramètres et des connexions, et ne contient pas de valeurs d’identifiants. La documentation de n8n prévient toutefois que les exports contiennent des noms et des identifiants techniques de credentials, et que les nœuds HTTP Request importés depuis cURL peuvent embarquer des en-têtes d’authentification. Inspectez les fichiers d’autrui avant de les exécuter, et les vôtres avant de les partager.

Puis-je importer tout un dossier de workflows d’un coup ?

Oui, mais seulement en ligne de commande : n8n import:workflow --separate --input=<dossier>. Par défaut, tous les workflows importés sont désactivés ; avec --activeState=fromJson, n8n reprend le champ active de chaque fichier, option réservée d’après la documentation aux modes multi-main et file d’attente.

Pourquoi le même fichier passe-t-il dans l’éditeur mais pas en ligne de commande ?

Parce que la ligne de commande écrit directement en base. Sur n8n 2.25.7, un JSON sans champ « id » de premier niveau a échoué avec SQLITE_CONSTRAINT: NOT NULL constraint failed: workflow_entity.id ; en ajoutant un « id », le même fichier s’est importé sans erreur. Les fichiers de modèles nettoyés omettent souvent ce champ volontairement.