Ressources · Intégration n8n

Nœud Execute Sub-workflow n8nConfigurer Execute Sub-workflow dans n8n.

Un workflow peut en appeler un autre, et c'est tout le métier du nœud Execute Sub-workflow n8n. Il charge un workflow enregistré depuis 4 origines possibles, lui passe les items en cours et attend son résultat si tu le demandes. Pratique dès qu'une même série d'étapes se retrouve dans plusieurs workflows.

Tester le nœud Execute Sub-workflow sur n8nVoir les 1 opérations

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert le nœud Execute Sub-workflow n8n ?

Le nœud Execute Sub-workflow n8n range tout un workflow derrière une seule étape. Les items posés sur son entrée partent dans le workflow désigné, qui tourne sur la machine hôte de n8n, puis le parent reprend sa route. n8n le dit sans détour : c'est l'outil qui découpe les workflows en modules et garde une seule source de vérité pour une série d'actions répétée souvent.

Le réglage qui décide de tout s'appelle Mode. Sur each, le sous-workflow est appelé une fois par item : cent fiches donnent cent exécutions séparées, chacune avec son propre contexte, ce qui convient quand le traitement d'une fiche n'a rien à voir avec celui de la suivante. Sur once, le lot entier entre dans une seule exécution, et c'est le bon choix pour une routine qui raisonne sur l'ensemble.

Deuxième usage, moins connu : le workflow appelé n'est pas forcément rangé dans l'instance. Source accepte localFile pour lire un fichier JSON enregistré, url pour le charger depuis une adresse distante, et parameter pour exécuter du JSON collé directement dans le nœud. De quoi garder un traitement partagé hors de l'interface, là où il se relit et se versionne.

Troisième usage, la réponse rapide. Wait For Sub-Workflow Completion décoché, le parent n'attend pas : il enchaîne son étape suivante pendant que le sous-workflow finit de son côté. Le parent rend donc la main tout de suite, et la partie lourde se termine sans bloquer personne.

Le nœud devient le mauvais choix dès que la brique visée n'est pas un workflow n8n. Ce qui vit derrière une API, c'est-à-dire une interface qu'un programme interroge, s'appelle avec le nœud HTTP Request, qui atteint n'importe quel endpoint HTTP et sert de recours quand un nœud dédié n'a pas l'opération voulue. Et une action unique garde son nœud à elle : déposer un fichier passe par Ftp, prévenir l'équipe par Slack. Un sous-workflow ne se justifie qu'à partir du moment où il en regroupe plusieurs.

Deux limites, enfin. Ce nœud n'ouvre pas une exécution : un déclencheur reste devant lui, Schedule Trigger, Webhook ou le trigger d'un outil. Et l'expression placée dans Workflow ID avec Source sur database réserve une surprise en exécution unique : tous les items filent vers le même workflow, car l'identifiant vient de l'expression évaluée sur le premier item d'entrée seulement. Un workflow différent par item, c'est Mode qui l'obtient. La Formation n8n travaille ce découpage en modules.

Actions

Comment configurer le nœud ?

Le nœud Execute Sub-workflow expose une opération. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

01

Execute a Sub-Workflow

call_workflow

Ce que tu vois dans n8n

Notes & cas d'usage

L'opération charge un autre workflow, le lance avec les items présents sur l'entrée du nœud, puis rend la main au workflow parent.

Paramètres clés

  • Source : d'où vient le workflow, database par identifiant, localFile depuis un fichier JSON enregistré, parameter depuis du JSON collé, ou url depuis une adresse distante.
  • Workflow ID : obligatoire avec database, lisible dans l'URL du workflow visé, souvent écrit {{ $json.field }}.
  • Mode : once passe tous les items dans une seule exécution, each appelle le sous-workflow une fois par item.
  • Wait For Sub-Workflow Completion : coché, le parent attend le résultat ; décoché, il enchaîne immédiatement.
Cas d'usage
un parent qui complète une liste de contacts, puis appelle un sous-workflow commun pour ranger les fiches nettoyées.
Besoin d'aide

Besoin d'aide pour automatiser Execute Sub-workflow avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Les questions qui viennent ensuite

01Le nœud Execute Sub-workflow est-il gratuit dans n8n ?
Oui. C'est un nœud core livré avec n8n : rien à installer, aucun coût supplémentaire côté n8n. Il fonctionne à l'identique sur n8n Cloud, l'offre hébergée par n8n, et sur une instance auto-hébergée installée en Docker ou en npm, sous Community Edition et sa licence Sustainable Use. Un workflow monté d'un côté se comporte pareil de l'autre. La seule chose qui change d'un hébergement à l'autre, c'est l'endroit où vit le sous-workflow appelé, puisque le nœud exécute les workflows sur la machine qui fait tourner n8n.
02Quels credentials demande le nœud Execute Sub-workflow n8n ?
Aucun. Ce nœud n'a rien à authentifier : pas de credential à créer, c'est-à-dire pas d'identifiants à enregistrer, et pas de sélecteur Authentication dans le panneau. Il n'y a donc aucun compte à connecter avant de s'en servir. Ce qu'il lui faut, c'est un workflow à appeler, et la façon de le désigner dépend de Source. Avec Database tu donnes un Workflow ID, lisible dans l'URL du workflow. Avec Local File tu donnes un Workflow Path du genre /data/workflow.json. Avec Parameter tu colles le Workflow JSON, et avec URL tu donnes le Workflow URL à charger.
03Quelles sont les limites du nœud Execute Sub-workflow ?
Il ne démarre rien de lui-même. Comme tout nœud qui n'est pas un trigger, il s'exécute sur les items qui lui arrivent : un Schedule Trigger, un Webhook ou le trigger d'un outil doit ouvrir le workflow parent avant lui. Il ne propose par ailleurs qu'une seule option, Wait For Sub-Workflow Completion, donc tout ce qui dépasse le fait d'attendre ou non se règle dans le sous-workflow. La page décrit la version 1 du nœud, la plus élevée du catalogue : un workflow ancien peut encore afficher une version antérieure avec moins d'options, et un nœud ne change jamais de version tout seul.
04Quand appeler un sous-workflow plutôt qu'utiliser HTTP Request ?
Ça dépend de l'endroit où vit le travail. Si les étapes à réutiliser forment déjà un workflow sur la même instance n8n, ce nœud l'appelle directement et lui transmet les items, sans URL ni authentification au milieu. Si le travail est derrière une API, HTTP Request est le bon nœud, puisqu'il appelle n'importe quel endpoint HTTP et couvre les opérations qu'un nœud dédié laisse de côté. En pratique : la réutilisation à l'intérieur de n8n passe par un sous-workflow, tout ce qui sort de n8n passe par HTTP Request ou par le nœud dédié à l'outil.
05n8n ou Make pour découper un process en sous-workflows ?
Les deux savent découper un process long en morceaux, donc le choix se joue ailleurs. Make est une plateforme d'automatisation hébergée, sans option d'auto-hébergement, facturée à l'opération : l'installation reste légère et le coût suit le volume. n8n tourne sur n8n Cloud ou sur ton propre serveur, donc les données restent où tu les mets et le coût suit l'hébergement plutôt que le nombre d'étapes. Quand une routine partagée est appelée sur chaque item de chaque exécution, c'est en général cette différence de modèle de facturation qui tranche.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.

Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations