Webhook

n8n : WebhookToutes les offresDéclencheur · 1 sortie

Démarre le workflow à la réception d'une requête HTTP sur une URL propre à ce déclencheur.

WebhookdéclencheurÉléments produits

Fonctionnement

URL de production active après publication ; URL de test active quelques minutes après « Écouter un appel de test » dans l'éditeur. Limite de débit par workflow, corps limité à 1 Mo, en-têtes sensibles jamais stockés. Un en-tête Idempotency-Key évite les doublons.

Paramètres

Paramètre	Type	Détail
Méthode HTTPobligatoire	choix	Valeurs : GET, POST, PUT, PATCH, DELETE, HEAD.
Cheminobligatoire	texte	Minuscules, chiffres, tirets, barres obliques. « :nom » capture un paramètre d'URL.
Authentification	choix	Valeurs : Aucune, En-tête secret, Basic (identifiant / mot de passe).
Identifiants attendusobligatoire · selon les autres paramètres	connexion	Connexion enregistrée de l'organisation.
Réponse	choix	Valeurs : Immédiate (accusé de réception), Par un bloc « Répondre au webhook ».
Code de la réponse immédiateselon les autres paramètres	choix	Valeurs : 202, 200, 204.
Attente maximale de la réponse (secondes)selon les autres paramètres	nombre	Au plus 55 s. Au-delà, l'appelant reçoit une erreur 504 contrôlée ; le workflow continue.
En-têtes transmis au workflow	texte	Liste séparée par des virgules. Vide : tous les en-têtes sauf cookies, authentification et adresses du proxy.
Exemple de corps (exécution manuelle)	JSON	Utilisé lors d'une exécution depuis l'éditeur.

Données reçues et renvoyées

EntréeAucune entrée.
SortieUn élément : { method, path, params, query, headers, body }.

Erreurs

401 si l'authentification échoue, 404 si le webhook est inconnu ou inactif, 405 si la méthode diffère, 413 si le corps est trop gros, 429 si le débit ou le quota est dépassé, 504 si aucune réponse n'arrive dans le délai (mode « Répondre au webhook »).

À savoir. Mode « Répondre au webhook » : la connexion reste ouverte jusqu'au bloc de réponse, au plus 55 s. Si le workflow se met en attente (bloc Attente), l'appelant reçoit aussitôt 202 avec l'identifiant d'exécution : utilisez-le pour suivre le traitement.

À savoir. Une requête ne reçoit jamais qu'une seule réponse.

Exemple

Paramètres d'un bloc prêt à l'emploi. Dans l'éditeur, l'onglet Aide du bloc applique cet exemple en un clic.

Paramètres de l'exemple (JSON)Ouvrir l'éditeur

{
  "method": "POST",
  "path": "commandes/:id",
  "auth": "header",
  "responseMode": "responseNode",
  "responseTimeoutSeconds": "20"
}