Tuto n8n : votre premier workflow en 20 minutes (testé sur n8n 2.45)
Par Clément Lacaille (Tech-Bharat) · Publié le 31 octobre 2026 · 4 min de lecture · notre méthode
Bundle FlowKit Complet — 269 €
12 workflows n8n prêts à importer, guide en français, garantie 14 jours
Pour faire votre premier workflow n8n, posez un déclencheur manuel, appelez une API publique avec le node HTTP Request, extrayez trois valeurs avec Edit Fields, aiguillez avec un node If, puis remplacez le déclencheur par un Schedule Trigger et cliquez sur Publish. Ce tuto le fait sur un exemple concret — être prévenu s'il pleut demain — que nous avons monté et exécuté sur n8n 2.45.7 (image Docker officielle) le 31 octobre 2026. Les sorties citées sont celles que n8n a renvoyées ce jour-là.

Ce qu'il faut avant de commencer
Une instance n8n 2.x : n8n Cloud, ou n8n sur votre ordinateur (voir installer n8n en local). Aucun compte tiers ni clé d'API : le tuto utilise Open-Meteo, une API météo publique gratuite pour un usage non commercial, sans clé. Comptez 20 minutes.
Deux mots à connaître : un node est une étape du workflow ; un item est une unité de données qui passe d'un node à l'autre. Un node s'exécute une fois par item reçu — retenez-le, il explique beaucoup de surprises.
Étape 1 : appeler l'API
- Créez un workflow et ajoutez le déclencheur Manual Trigger (« When clicking 'Execute workflow' »). Il ne sert qu'aux essais.
- Ajoutez un node HTTP Request : méthode
GET, URLhttps://api.open-meteo.com/v1/forecast. - Activez Send Query Parameters et ajoutez :
latitude=48.8566,longitude=2.3522(Paris),daily=precipitation_sum,temperature_2m_max,timezone=Europe/Paris,forecast_days=2. - Cliquez sur Execute workflow.
Résultat dans notre labo (extrait) :
{
"timezone": "Europe/Paris",
"daily": {
"time": ["2026-10-31", "2026-11-01"],
"precipitation_sum": [0, 0],
"temperature_2m_max": [15.7, 12.8]
}
}
L'API ne renvoie pas une liste de jours mais trois listes parallèles. Demain est à la position 1 de chacune (on compte à partir de 0). Lire la forme exacte d'une réponse avant d'écrire la suite est la première habitude à prendre.
Étape 2 : extraire et décider
- Ajoutez Edit Fields (Set), nommé « Demain », avec trois champs :
date(String) ={{ $json.daily.time[1] }};pluie_mm(Number) ={{ $json.daily.precipitation_sum[1] }};temp_max(Number) ={{ $json.daily.temperature_2m_max[1] }}. - Ajoutez un node If : valeur
{{ $json.pluie_mm }}, opérateur Number › is greater than or equal to, valeur1. - Exécutez.
Sortie de « Demain » dans notre labo : {"date":"2026-11-01","pluie_mm":0,"temp_max":12.8}. L'item est parti dans la sortie false du node If (0 mm prévu). Branchez sur la sortie true ce que vous voulez : un e-mail, un message Telegram, une ligne dans une table.

Étape 3 : planifier et publier
- Remplacez le Manual Trigger par un Schedule Trigger : Trigger Interval = Days, Days Between Triggers = 1, Trigger at Hour = 7am.
- Dans les réglages du workflow (menu … › Settings), vérifiez Timezone.
- Cliquez sur Publish.
Depuis n8n 2.0, l'éditeur enregistre vos modifications sans toucher à la version en production : seule la dernière version publiée tourne (ce qui change avec Save et Publish). Les passages du workflow apparaissent dans l'onglet Executions, avec les données de chaque node.
Les 4 pièges que nous avons rencontrés
| Piège | Ce qui se passe | La parade |
|---|---|---|
| Fuseau horaire | Sans réglage, une instance auto-hébergée utilise GENERIC_TIMEZONE, dont la valeur par défaut est America/New_York : « 7 h » part à 13 h, heure de Paris |
Régler le fuseau du workflow, et GENERIC_TIMEZONE sur l'instance |
| Types | Le node If compare en mode strict : un texte « 0 » comparé à un nombre provoque une erreur de type | Déclarer le champ en Number, ou activer Convert types where required |
| Oubli de publier | Une correction enregistrée mais non publiée ne s'applique jamais en production | Cliquer sur Publish après chaque changement validé |
| Échec silencieux | Une API en panne fait échouer l'exécution, sans prévenir personne | Un workflow d'erreur (Error Trigger) relié dans les réglages du workflow |
Pour le dernier point, voir gérer les erreurs avec un Error Workflow : dans notre labo, une API qui répondait 503 a donné le message « Service unavailable - try again later or consider setting this node to retry automatically (in the node settings) », reçu par le workflow d'erreur.
Et ensuite
Ce workflow contient déjà les briques de la plupart des automatisations : un déclencheur, un appel d'API, une transformation, une décision. Les suivantes sont le traitement d'une liste (Filter, Aggregate), le stockage (Data Tables), la réception de données (Webhook, formulaire) et la gestion des erreurs. Pour déboguer un workflow qui ne fait pas ce que vous attendez, la vue JSON de chaque node reste votre meilleur outil.
FAQ
Questions fréquentes
Faut-il savoir programmer pour suivre ce tuto n8n ?
Non. Le workflow utilise trois expressions d'une ligne, du type {{ $json.daily.time[1] }}, qui lisent un champ de la réponse ; aucun node Code n'est nécessaire.
Ce tuto fonctionne-t-il sur n8n Cloud ?
Oui : Manual Trigger, HTTP Request, Edit Fields, If et Schedule Trigger existent sur n8n Cloud comme en auto-hébergé. Seule la variable GENERIC_TIMEZONE, qui fixe le fuseau par défaut de l'instance, concerne l'auto-hébergé.
Pourquoi mon workflow planifié ne se lance-t-il pas ?
Dans n8n 2.x, un workflow ne tourne seul qu'une fois publié avec le bouton Publish ; une modification enregistrée mais non publiée ne s'applique pas en production. Vérifiez aussi le fuseau du workflow : sans réglage, une instance auto-hébergée utilise America/New_York.
Pourquoi l'API renvoie-t-elle des listes et pas une liste de jours ?
Open-Meteo renvoie des tableaux parallèles (time, precipitation_sum, temperature_2m_max) : la valeur de demain est à l'index 1 de chacun. C'est la forme de cette API ; d'autres renvoient un tableau d'objets, que n8n découpe alors automatiquement en un item par élément.