HubSpot Update Company
Le node HubSpot Update Company met à jour les propriétés d'une entreprise dans HubSpot CRM via l'API HubSpot, à partir d'un identifiant de société et d'un JSON de propriétés fournis dans les paramètres ou par les nodes en amont.
À quoi sert le node HubSpot Update Company ?
Le node HubSpot Update Company met à jour une ou plusieurs propriétés sur une fiche entreprise existante dans votre CRM HubSpot. Vous fournissez l’identifiant de l’entreprise et un objet JSON décrivant les propriétés à modifier, et le node appelle l’API HubSpot pour appliquer la mise à jour.
Cas d’usage typiques :
- Enrichir une fiche entreprise avec des données extraites de son site (secteur, effectif, stack technique)
- Définir un lead score ou un lifecycle stage à partir d’une analyse LLM de l’activité récente
- Réécrire dans HubSpot des notes ou des résumés générés par IA
- Synchroniser des champs depuis une autre source (Notion, Sheets, BigQuery) vers HubSpot de façon planifiée
Configuration rapide
Ajoutez le node sur le canvas
Ouvrez la Node Library, allez dans Integrations > HubSpot, puis glissez le node HubSpot Update Company sur le canvas.
Connectez votre intégration HubSpot
Ouvrez les paramètres du node et choisissez votre HubSpot Integration dans la liste déroulante. Si aucune n’existe, ajoutez-la dans Settings > Integrations. L’intégration doit disposer du droit d’écriture sur les entreprises.
Indiquez l’identifiant de l’entreprise
Renseignez Company ID dans les paramètres, ou branchez un node en amont (par exemple HubSpot Get Company ou HubSpot List Companies) sur le port d’entrée company_id. La valeur d’entrée prime sur le paramètre statique.
Indiquez le JSON des propriétés
Renseignez Properties JSON avec l’objet des champs à mettre à jour, par exemple {"industry": "SaaS"}. Vous pouvez aussi envoyer le JSON dynamiquement via le port d’entrée properties depuis un LLM ou tout autre node en amont.
Connectez la sortie
Branchez le port de sortie sur le node suivant. Le node renvoie la fiche entreprise mise à jour sous forme de chaîne JSON dans la sortie company_data, prête à être parsée ou journalisée en aval.
Paramètres de configuration
Champs obligatoires
integration_id integration required HubSpot Integration — Choisit le compte HubSpot à appeler. L’intégration doit avoir été autorisée dans Settings > Integrations pour apparaître dans la liste déroulante.
company_id string required Company ID — L’identifiant interne HubSpot de l’entreprise à mettre à jour (par exemple 12345678901). Obligatoire à l’exécution : passez-le via le port d’entrée company_id ou renseignez-le directement dans les paramètres.
properties textarea required Properties JSON — Un objet JSON dont les clés sont des noms de propriétés d’entreprise HubSpot et les valeurs les nouvelles valeurs. Obligatoire à l’exécution : passez-le via le port d’entrée properties ou renseignez-le directement dans les paramètres.
{
"name": "New Company Name",
"domain": "example.com",
"industry": "Technology"
}Champs optionnels
Name string default: HubSpot Update Company Nom du node — Libellé affiché sur le canvas. Pratique quand plusieurs nodes de mise à jour cohabitent (par exemple Enrich industry ou Set lifecycle stage).
Description string Description du node — Note courte affichée dans l’en-tête du node pour clarifier son rôle pendant le debug.
Company ID et Properties JSON peuvent tous deux être fournis via les ports d’entrée. Le runner utilise la valeur d’entrée si elle est présente, sinon le paramètre statique — un même template de node peut donc servir pour de nombreuses entreprises.
Que produit le node en sortie ?
Le node renvoie la réponse de l’API HubSpot pour l’entreprise mise à jour, sous forme de chaîne JSON, sur la sortie company_data. Cette chaîne contient l’identifiant de l’entreprise et les propriétés enregistrées par HubSpot après le patch.
{
"id": "12345678901",
"properties": {
"name": "New Company Name",
"domain": "example.com",
"industry": "Technology",
"hs_lastmodifieddate": "2025-04-15T10:32:11.000Z"
},
"createdAt": "2024-01-12T09:01:44.000Z",
"updatedAt": "2025-04-15T10:32:11.000Z",
"archived": false
}company_data string Une chaîne JSON contenant l’objet entreprise HubSpot mis à jour, avec l’id, la map properties fusionnée et les timestamps. Analysez-la avec un JSON Path Extractor pour lire les champs un à un en aval.
Exemples d’utilisation
Exemple 1 : Enrichir une entreprise avec des données scrapées
Vous partez d’une entreprise HubSpot, scrapez son site, demandez à un LLM d’extraire des firmographiques structurées, puis réécrivez le résultat dans HubSpot.
Configuration :
- Company ID : branché depuis un node HubSpot Get Company
- Properties JSON : branché depuis un node LLM qui renvoie du JSON
Properties JSON envoyé (depuis le LLM) :
{
"industry": "SaaS",
"numberofemployees": "120",
"description": "AI-driven workflow automation for SEO teams."
}Après l’exécution, les trois champs apparaissent sur la fiche de l’entreprise dans HubSpot.
Exemple 2 : Mettre à jour le lifecycle stage avec une valeur statique
Vous qualifiez une entreprise manuellement et souhaitez faire avancer son lifecycle stage en un clic.
Configuration :
- Company ID :
12345678901 - Properties JSON :
{
"lifecyclestage": "marketingqualifiedlead",
"hs_lead_status": "OPEN_DEAL"
}Aucun branchement nécessaire — le node utilise les paramètres statiques et s’exécute une fois par run.
Exemple 3 : Boucler sur une liste d’entreprises pour uniformiser un champ
Combinez HubSpot List Companies avec un node Loop, puis injectez chaque identifiant dans HubSpot Update Company avec un payload properties fixe pour corriger massivement un champ dans le CRM.
Problèmes courants
Le node échoue avec `Company ID is required`
Cause : Ni le port d’entrée company_id, ni le paramètre Company ID n’a fourni de valeur non vide à l’exécution.
Solution : Vérifiez que le node en amont envoie bien une chaîne dans company_id, ou renseignez l’identifiant en dur dans les paramètres. Une chaîne vide est considérée comme manquante.
Le node échoue avec `Properties JSON is required`
Cause : L’entrée properties ou le paramètre Properties JSON est vide.
Solution : Fournissez un objet JSON non vide. Pour vider un champ HubSpot, envoyez la propriété avec une valeur de chaîne vide, par exemple {"description": ""} — ne supprimez pas la clé.
HubSpot renvoie une erreur de propriété invalide
Cause : Les clés JSON doivent correspondre aux noms internes des propriétés HubSpot, qui diffèrent des libellés (par exemple numberofemployees, pas Nombre d'employés).
Solution : Récupérez le nom interne dans HubSpot via Settings > Properties, ou interrogez un échantillon avec HubSpot Get Company et recopiez les clés depuis sa map properties.
HubSpot renvoie une erreur d'autorisation ou de scope
Cause : L’intégration HubSpot connectée ne dispose pas du scope crm.objects.companies.write, ou son token OAuth a été révoqué.
Solution : Reconnectez le compte HubSpot dans Settings > Integrations et réautorisez-le avec les permissions d’écriture sur les entreprises.
Le Properties JSON est rejeté comme mal formé
Cause : La valeur du textarea n’est pas du JSON valide — souvent à cause de guillemets non échappés, de virgules en fin d’objet ou de simples quotes.
Solution : Validez le payload avec un linter JSON avant de lancer. Lorsque le JSON vient d’un LLM, placez un node Find and Replace en amont pour retirer les fences Markdown comme ```json.
Bonnes pratiques
Ne mettez à jour que les champs réellement modifiés. HubSpot fusionne le payload : un JSON minimal garde le journal d’audit lisible et évite d’écraser des champs maintenus par d’autres outils.
Validez la sortie LLM avant écriture. Quand le JSON properties est généré par un LLM, faites-le passer par un Find and Replace pour retirer les fences de code, puis par un JSON Path Extractor pour vérifier la structure avant de l’envoyer à HubSpot.
Attention aux rate limits HubSpot. Lors d’une mise à jour en boucle, throttlez le workflow ou batchez les updates : l’API HubSpot standard autorise environ 100 requêtes par 10 secondes par intégration, au-delà les appels renvoient des erreurs 429.
Testez d’abord sur un sandbox. Ce node écrit dans le CRM en production et il n’y a pas d’undo automatique. Lancez les nouvelles automatisations sur un sandbox HubSpot ou une seule entreprise de test avant de monter en charge.
Comment s’intègre-t-il dans un workflow ?
HubSpot Update Company se place en fin de pipeline d’enrichissement, pour persister le résultat du scraping ou du traitement IA en amont dans le CRM.
graph LR
Get[HubSpot Get Company] --> Scrape[Web Scraper]
Scrape --> LLM[LLM extrait les firmographiques]
LLM --> Update[HubSpot Update Company]Nodes associés
Récupérez une entreprise avant la mise à jour pour lire les propriétés existantes ou confirmer l’identifiant.
Itérez sur de nombreuses entreprises pour appliquer la même mise à jour à grande échelle.
Générez le JSON properties à partir de texte non structuré (sites scrapés, notes d’appel).
Lisez les champs du JSON company_data renvoyé pour les utiliser dans les nodes en aval.