Comment utiliser le nœud Webhook dans n8n

Le nœud Webhook est le point d'entree le plus utilise pour déclencher un workflow n8n depuis l'extérieur. Il crée une URL HTTP que n'importe quel service, formulaire ou application peut appeler pour lancer l'exécution d'un workflow. C'est la base pour connecter n8n à un site web, une application mobile ou tout système tiers.

Ce tutoriel couvre la configuration complète du nœud Webhook : les deux types d'URL (test et production), le choix de la méthode HTTP, l'authentification, les modes de réponse et les options avancées de sécurité. Un cas pratique en fin de video illustre les erreurs courantes et comment les eviter.

Test URL vs Production URL

Le nœud Webhook expose deux URL distinctes avec des comportements différents :

• Test URL - utilisee pendant le développement. Necessite de cliquer sur "Listen for test event" dans n8n pour être active. L'URL change à chaque modification du workflow.
• Production URL - utilisee en conditions reelles. Necessite uniquement que le workflow soit actif (toggle en haut à droite). L'URL reste stable tant que le path ne change pas.

Erreur frequente : appeler la test URL sans avoir lance "Listen for test event", ou appeler la production URL sans avoir active le workflow. Dans les deux cas, n8n retourne une erreur 404.

Methode HTTP et Path

Le webhook accepte les méthodes GET, POST, PATCH et DELETE. Le choix depend de l'usage :

• GET - pour les liens cliquables (newsletter, email, redirection). Les paramètres passent dans l'URL.
• POST - pour les formulaires HTML, les appels JavaScript et les intégrations d'applications. Les données sont dans le body, invisible pour l'utilisateur.

Si la méthode HTTP est configurée sur POST et qu'un appel arrive en GET, le webhook l'ignore. L'option "Allow multiple HTTP methods" dans les Settings permet d'accepter toutes les méthodes.

Le champ Path permet de personnaliser la fin de l'URL. Au lieu d'un identifiant aléatoire, on peut ecrire un nom lisible comme newsletter ou inscription. L'URL devient alors https://n8n.domaine.fr/webhook/newsletter.

Authentification

Par defaut, le webhook est accessible à tous. Trois types d'authentification sont disponibles pour securiser l'accès :

Type	Principe	Cas d'usage
Basic Auth	Identifiant + mot de passe envoyes dans le header Authorization	Acces restreint à une équipe interne
Header Auth	Cle API envoyée dans un header personnalise	Integration avec des services tiers
JWT	Jeton signe vérifie par n8n	Applications avec système d'authentification existant

Modes de réponse

Le webhook offre 3 modes de réponse qui déterminent quand et quoi renvoyer à l'appelant :

• Immediately - répond des que le webhook est déclenche, sans attendre la fin du workflow. Ideal pour ne pas bloquer l'utilisateur.
• When Last Node Finishes - attend la fin complète du workflow avant de répondre. Permet de renvoyer le résultat du traitement.
• Using Respond to Webhook Node - attend un nœud spécifique dans le workflow pour construire la réponse. Permet de renvoyer des réponses différentes selon les cas (succes, erreur, doublon).

Le troisieme mode est le plus puissant : il permet de créer de veritables API avec gestion d'erreurs, codes de statut personnalisés (200, 400, 403, 404) et messages adaptes.

Options avancées

Option	Description
Allowed Origins (CORS)	Liste des domaines autorisés à appeler le webhook depuis un navigateur
Binary Data Field Name	Nom de reference pour les fichiers recus (images, PDF) dans le workflow
Ignore Bots	Refuse les requêtes identifiees comme venant de robots
IP Whitelist	N'accepte que les requêtes provenant d'adresses IP spécifiques
No Response Body	Retourne une réponse HTTP sans contenu (utile pour les pings)
Response Code	Code HTTP personnalise (200, 201, 400, 403, 404...)
Response Data	Donnees renvoyées immédiatement à l'appelant
Response Headers	Headers HTTP personnalisés dans la réponse