Intégration HubSpot n8nAutomatiser HubSpot avec n8n.

Une seule information suffit pour poser une fiche entreprise dans HubSpot : son nom. Le reste se remplit dans la foulée, ou plus tard.

• Name : le nom de l'entreprise, seul champ requis, souvent repris du nœud précédent avec une expression, c'est-à-dire une référence à un champ de l'item entrant, du type {{ $json.company }}.
• Company Properties : la collection facultative de 34 champs, dont Website URL, la propriété que HubSpot utilise pour identifier une entreprise de façon unique.
• Industry Name or ID : le type d'activité, choisi dans la liste ou passé par une expression.

Supprimer une entreprise tient en un champ, et l'opération ne demande rien d'autre.

• Company to Delete : un sélecteur de ressource, tu désignes la fiche dans une liste déroulante ou tu passes son identifiant, par exemple celui que renvoie une recherche placée juste avant.

Lire une fiche entreprise sert surtout à enrichir la suite du workflow, quand un identifiant arrive d'un trigger ou d'une recherche.

• Company to Get : la fiche à récupérer, désignée dans la liste ou par son identifiant.
• Include Merge Audits : désactivé par défaut ; activé, il ajoute l'historique de fusion quand l'entreprise a déjà été fusionnée avec une autre fiche.

Ici on ne vise plus une fiche mais un lot. C'est l'opération des exports et des comparaisons avec une autre base.

• Return All : coché, n8n enchaîne les pages de l'API et ramène toutes les entreprises ; décoché, Limit fixe le nombre maximal de fiches renvoyées.
• Company Properties to Include : les propriétés à embarquer avec chaque entreprise, choisies une par une dans la liste.

Variante bornée de la lecture en masse : seules les entreprises créées ou modifiées récemment remontent, ce qui évite de relire tout le CRM à chaque exécution.

• Since : la date plancher, au format YYYY-MM-DD hh-mm-ss quand la valeur vient d'une expression ; seules les entreprises créées après cet horodatage sortent.
• Return All et Limit : le même couple que pour la lecture complète, à caler sur la fenêtre choisie.

Le domaine du site sert de clé de recherche. C'est la façon la plus directe de savoir si une entreprise est déjà dans le CRM avant d'en créer une deuxième.

• Domain : le domaine du site de l'entreprise cherchée, du genre n8n.io, requis.
• Company Properties to Include : les propriétés à ramener avec les résultats, choisies dans la liste ou passées par une expression.

Mettre à jour, c'est écrire sur une fiche qui existe déjà. Les 35 propriétés modifiables vivent dans une collection dédiée.

• Company to Update : la fiche visée, désignée dans la liste ou par son identifiant.
• Update Fields : les 35 propriétés modifiables, de Name à Lifecycle Stage Name or ID en passant par Annual Revenue.
• Custom Properties : pour les propriétés créées par ton équipe, absentes de la liste standard.

Une opération unique pour créer un contact ou mettre à jour celui qui existe déjà, ce que n8n appelle un upsert. L'email est le seul champ requis.

• Email : l'adresse du contact, au format name@email.com.
• Contact Properties : 67 champs facultatifs, dont First Name, Job Title, Lifecycle Stage Name or ID et Associated Company Name or ID pour rattacher le contact à une entreprise.
• Simplify Output : sans lui, la réponse ne contient que l'identifiant ; activé, n8n résout les données automatiquement.

La suppression réclame l'identifiant numérique du contact, pas son adresse email. C'est le piège le plus fréquent sur cette ressource.

• Contact to Delete : l'identifiant du contact, un nombre du genre 1485 ; pour partir d'une adresse, il faut d'abord passer par l'opération de recherche.

Attention au comportement par défaut : la lecture d'un contact ne renvoie que son identifiant. Les valeurs de propriétés n'arrivent que si tu les demandes.

• Contact to Get : l'identifiant numérique, là encore pas l'email.
• Contact Properties to Include : les propriétés à faire remonter ; le paramètre s'ajoute autant de fois qu'il y a de propriétés voulues.
• Form Submission Mode : quelles soumissions de formulaire accompagnent le contact, toutes, aucune, la plus récente ou la plus ancienne.

Le lot complet des contacts, page après page. Deux usages reviennent tout le temps : l'export et l'audit de base.

• Return All : activé, n8n parcourt toutes les pages de l'API HubSpot ; sinon Limit plafonne le nombre de contacts renvoyés.
• Include List Memberships : ajoute les listes auxquelles chaque contact appartient, ce qui évite un second appel par fiche.

Même lecture en masse, restreinte aux contacts créés ou modifiés récemment. Pas de champ de date ici, contrairement aux entreprises et aux deals.

• Return All et Limit : le couple habituel, à régler sur la fréquence d'exécution du workflow.
• Contact Properties to Include : les propriétés à embarquer, sans quoi le résultat reste maigre.

La recherche croise des conditions au lieu de tout ramener. Trois groupes de filtres au maximum, avec jusqu'à trois filtres chacun.

• Filter Groups : les filtres d'un même groupe se combinent avec un ET, les groupes entre eux avec un OU.
• Query : une recherche en texte libre sur toutes les valeurs de propriétés du contact.
• Sort Order : le sens dans lequel les résultats sortent, décroissant par défaut.

Deux chemins mènent au même résultat, l'identifiant ou l'email, et un champ décide lequel des deux tu empruntes.

• By : deux valeurs possibles, Contact ID ou Email.
• Contact to Add : l'identifiant numérique du contact, quand tu passes par Contact ID.
• Email : l'adresse, au format name@email.com, quand tu passes par Email.
• List to Add To : l'identifiant numérique de la liste d'arrivée.

Le retrait n'offre pas le choix entre email et identifiant : il faut le numéro du contact, et celui de la liste.

• Contact to Remove : l'identifiant numérique du contact à sortir.
• List to Remove From : l'identifiant numérique de la liste concernée.

Ouvrir une opportunité réclame une seule chose, son étape dans le pipeline. Montant, nom et date de signature vivent à côté, dans une collection de dix propriétés.

• Deal Stage Name or ID : requis à la création, choisi dans la liste ou passé par une expression.
• Deal Properties : la collection facultative, avec Amount, Deal Name, Close Date et Pipeline Name or ID.
• Deal Owner : l'utilisateur HubSpot à qui le deal est attribué.

Rien à régler en dehors du deal visé. L'opération retire l'opportunité du compte.

• Deal to Delete : le deal à supprimer, choisi dans la liste ou désigné par son identifiant.

Comme pour les contacts, la lecture d'un deal renvoie son identifiant et rien de plus tant que les propriétés ne sont pas demandées.

• Deal to Get : le deal à lire, dans la liste ou par identifiant.
• Deal Properties to Include : les propriétés à faire remonter, à répéter autant de fois que nécessaire.
• Include Property Versions : ramène toutes les versions précédentes d'une propriété, au lieu de la seule valeur en cours.

La vue d'ensemble du pipeline. Une option change tout ici, celle qui ramène le rattachement aux contacts et aux entreprises.

• Include Associations : ajoute les identifiants des contacts et des entreprises liés, ainsi que la propriété num_associated_contacts.
• Return All : ramène tout le pipeline en enchaînant les pages ; sinon Limit borne le nombre de deals.
• Deal Properties with History to Include : comme la liste de propriétés, mais avec leur historique.

La lecture incrémentale du pipeline : seuls les deals récents remontent, ce qui raccourcit l'exécution à mesure que la base grossit.

• Since : la borne de départ, au format YYYY-MM-DD hh-mm-ss dans une expression ; seuls les deals créés après cet horodatage sortent.
• Include Property Versions : ajoute les versions précédentes des propriétés, pratique pour suivre les changements d'étape.

Le même moteur de recherche que pour les contacts, appliqué au pipeline : des filtres, un tri, et seulement les deals qui correspondent.

• Filters : limite les résultats aux deals dont les valeurs de propriétés correspondent à ce que tu as posé.
• Sort By : la propriété qui sert de critère de tri.
• Direction : le sens du tri, décroissant par défaut. Le champ porte ici un autre nom que sur les contacts.

Neuf propriétés modifiables, dont l'étape : c'est l'opération des workflows qui font avancer un deal sans qu'un commercial clique.

• Deal to Update : le deal à modifier, dans la liste ou par identifiant.
• Deal Stage Name or ID : facultatif ici, alors qu'il est requis à la création.
• Pipeline : un simple texte sur cette opération, là où la création propose une liste déroulante.

Les appels, e-mails, réunions et tâches vivent dans la chronologie HubSpot. Cette opération y ajoute une entrée depuis un workflow.

• Type : le seul champ obligatoire, à choisir entre call, email, meeting et task.
• Metadata : Subject porte le titre de l'activité, Body son texte, Status son état (NOT_STARTED, IN_PROGRESS, WAITING, DEFERRED, COMPLETED).
• For Object Type : CONTACT ou COMPANY, selon la fiche qui doit porter l'activité ; Associations complète ce rattachement.

Erreur de saisie, doublon, activité laissée par un essai : elle sort de la chronologie avec cette opération.

• Engagement to Delete : l'identifiant de l'activité, saisi à la main ou repris d'une lecture précédente avec {{ $json.id }}.

Tu donnes l'identifiant d'une activité, le nœud va chercher son détail dans HubSpot et le passe à la suite du workflow.

• Engagement to Get : désigne l'activité à lire ; une valeur fixe rend les essais lisibles, une expression prend le relais une fois le nœud branché derrière un autre.

Rien à préciser côté objet ici : l'opération remonte les activités du compte, page après page.

• Return All : sans lui, n8n s'arrête au nombre d'activités fixé par Limit ; avec, il remonte tout l'historique, page après page.
• Limit : le nombre maximal d'activités renvoyées, pratique pour tester un workflow sans rapatrier tout l'historique.

Un ticket naît toujours dans un pipeline, à une étape précise, avec un nom lisible par le support. Côté credential, le scope tickets fait partie des droits recommandés pour le nœud.

• Pipeline Name or ID : le pipeline de service qui accueille le ticket, pris dans la liste ou passé en identifiant.
• Stage Name or ID : l'étape de départ ; la liste dépend du pipeline, donc choisis le pipeline d'abord.
• Ticket Name : l'intitulé affiché dans HubSpot.
• Ticket Properties : Description, Priority Name or ID et Ticket Owner Name or ID pour l'attribution.

Quand un ticket ne doit plus exister côté HubSpot, cette opération le supprime à partir de son seul identifiant.

• Ticket to Delete : le ticket à supprimer, choisi dans la liste du sélecteur ou repris d'un nœud précédent.

Lire un ticket un par un sert surtout à nourrir la suite du workflow : tu choisis les propriétés qui arrivent, et rien d'autre ne transite.

• Ticket to Get : le ticket à lire.
• Ticket Properties to Include : les propriétés à ramener, cochées dans la liste.
• Properties With History : même principe, mais avec l'historique des valeurs d'une propriété au lieu de sa valeur du moment.
• Include Deleted : inclut les tickets supprimés dans le résultat.

La file complète des tickets sort d'ici, avec le choix des propriétés embarquées pour ne pas traîner une fiche entière à chaque item.

• Return All : ramène tous les tickets en suivant la pagination de l'API ; sans lui, Limit fixe le nombre de tickets renvoyés.
• Ticket Properties to Include : les propriétés embarquées dans chaque ticket de la liste.
• Properties With History : à sortir quand l'évolution d'une propriété compte plus que son état actuel.

Treize champs facultatifs, et tu ne remplis que ceux qui bougent : l'étape, le propriétaire, la résolution.

• Ticket to Update : le seul champ obligatoire, le ticket concerné.
• Stage Name or ID : la nouvelle étape ; si le ticket change de pipeline, corrige aussi Pipeline Name or ID.
• Resolution Name or ID et Close Date : l'action qui a réglé la demande et la date de clôture, au format YYYY-MM-DD hh-mm-ss.
• Ticket Owner Name or ID : la personne de l'équipe qui reprend le dossier.