Comment créer et utiliser les webhooks de Hubspot ?

Les webhooks permettent à HubSpot d’envoyer automatiquement des notifications lorsque des événements spécifiques se produisent (création d’un contact, changement de phase dans un deal, etc.). Dans cet article, nous allons découvrir comment créer et configurer un webhook dans HubSpot, puis comment l’exploiter avec n8n pour automatiser certaines tâches.

Créer une Private App dans HubSpot

Accéder aux paramètres

Dans votre compte HubSpot, cliquez sur la roue dentée (ou votre photo de profil) pour accéder aux Paramètres.

×

Aller dans « Integrations »

Dans le menu de navigation à gauche, recherchez et cliquez sur Integrations (ou Intégrations en français) puis dans Private Apps.

×

Créer une « Private App »

• Sélectionnez Private Apps.
• Cliquez ensuite sur le bouton Create private app.
• Donnez un nom et, si vous le souhaitez, une description à votre application privée.
• Enregistrez vos modifications.

×

×

Une Private App vous permettra de gérer vos webhooks et vos API Keys. Elle est plus sécurisée et granulaire que l’ancienne méthode basée sur les API keys.

Créer un trigger Webhook dans n8n

Dans n8n, nous allons configurer un trigger Webhook qui attendra la requête provenant de HubSpot :

×

Ajouter un node « Webhook »

• Dans votre workflow n8n, cliquez sur Add node, puis choisissez Webhook dans la liste.
• Sélectionnez “Trigger” comme type de webhook pour qu’il déclenche le workflow à chaque appel.

Changez la méthode HTTP en Post

Récupérer l’URL de test

• Dans les propriétés du nœud Webhook, vous verrez une URL du type
  https://<nom_du_workspace>.app.n8n.cloud/webhook/... (ou une URL avec votre nom de domaine si vous hébergez n8n vous-même).
• Copiez cette URL de test.

×

Coller l’URL dans HubSpot

• Revenez dans la configuration de votre webhook dans HubSpot et collez la Target URL copiée depuis n8n.

×

L’avantage d’utiliser l’URL de test vous permet de voir rapidement les requêtes entrantes dans n8n avant de passer en production. Vous pouvez ainsi déboguer plus facilement votre workflow.

Configurer le webhook dans HubSpot

Une fois votre Private App nommée et avec une description, vous pouvez y configurer vos webhooks :

Créer une subscription (abonnement) Webhook

• Cliquez sur Create subscription.

×

Sélectionner l’objet et l’événement à suivre

Toujours dans HubSpot, au moment de créer ou de modifier votre subscription :

Choisir l’objet

Contact (création, suppression, etc.)

Deal (changement de phase, mise à jour…)

Ticket, etc.

Dans mon exemple, j’ai pris les contacts mais cela dépend de votre use case.

Vous pouvez en séléctionner plus.

×

Sélectionner le type d’événement

Création (ex. Contact creation)

Suppression (ex. Contact deletion)

Mise à jour (changement de phase dans un deal, modification d’une propriété, etc.)

Valider

Cliquez sur Create subscription (ou “Sauvegarder”) pour enregistrer vos préférences.

Dans mon exemple, j’ai pris l’événement création mais cela dépend de votre use case.

Vous pouvez en séléctionner plus.

N’oubliez pas d’ajouter le scope requis pour que cela fonctionne

×

Pour terminer, finalisez la création de l’app

Tester le webhook

Une fois la subscription créée, HubSpot va généralement essayer de vérifier que l’URL répond bien (code 200).

Activer le webhook dans n8n

Mettez votre node Webhook en mode “Test” en cliquant sur « Listen for test even ».

n8n est alors prêt à recevoir la requête.

×

Forcer un test depuis HubSpot

Retournez dans l’app que vous venez de créer. Allez dans Webhooks puis allez dans le détail de la souscription à l’événement,

×

Vous pouvez cliquer sur un bouton du type Test.

×

HubSpot enverra alors une requête à l’URL fournie. Hubspot renvoie le code 200 quand le webhook a été correctement envoyé à l’URL. Si Hubspot retourne le code 404, il y a probablement un problème sur votre outil d’automation.

×

Consulter la réponse dans n8n

• Allez dans l’onglet Execution (ou regardez la console en temps réel).
• Vous devriez voir la requête en output (JSON) décrivant l’événement testé.

×

C’est une requête de test mais il vous suffit de changer l’URL de test par l’URL de production dans n8n et de faire le changement dans la souscription d’événement dans Hubspot.

Votre webhook fonctionne maintenant parfaitement !

Automatiser vos workflows avec n8n

Maintenant que la connexion est opérationnelle, vous pouvez enchaîner sur le workflow n8n :

• Recevoir l’événement webhook (contact créé, deal modifié…).
• Exécuter des actions (mettre à jour une database Notion, notifier Slack, envoyer un email, etc.).
• Stocker les données ou les transmettre à un autre service (ERP, Data Warehouse…).