HubSpot Get Company

Le node HubSpot Get Company récupère les informations détaillées d'une ou plusieurs entreprises HubSpot à partir de leur ID, avec un choix configurable de propriétés et d'objets associés.

À quoi sert le node HubSpot Get Company ?

Le node HubSpot Get Company récupère les informations détaillées d’une ou plusieurs entreprises de votre CRM HubSpot à partir de leur identifiant. Vous choisissez quelles propriétés de l’entreprise renvoyer et quels objets associés (contacts, deals, tickets, etc.) inclure avec chaque enregistrement.

Cas d’usage typiques :

• Enrichir un workflow avec les détails complets d’une entreprise (secteur, chiffre d’affaires, effectif) à partir d’un ID
• Récupérer une entreprise et ses deals ou contacts associés pour construire des fiches compte ou des récapitulatifs commerciaux
• Résoudre une liste d’IDs d’entreprises produite par un node en amont en enregistrements structurés pour un LLM ou un rapport
• Consulter un compte avant d’envoyer un email d’outreach personnalisé

Configuration rapide

Paramètres de configuration

Champs obligatoires

Champs optionnels

Que produit le node en sortie ?

Le node produit une chaîne JSON sous company_data contenant le ou les enregistrements d’entreprise indexés par ID, avec les propriétés demandées et les éventuelles associations sélectionnées.

{
  "123456": {
    "id": "123456",
    "properties": {
      "name": "Acme Inc",
      "domain": "acme.com",
      "industry": "Technology",
      "annualrevenue": "5000000",
      "numberofemployees": "75"
    },
    "associations": {
      "contacts": ["301", "302", "303"],
      "deals": ["9001"]
    }
  }
}

Exemples d’utilisation

Exemple 1 : Enrichir une entreprise avant un envoi d’outreach

Vous avez un ID d’entreprise dans une variable de workflow et vous voulez rédiger un email d’introduction sur mesure.

Configuration :

• Intégration HubSpot : votre connexion CRM
• Company ID(s) : 123456
• Properties : name, domain, industry, description, annualrevenue, numberofemployees
• Associations : (vide)

Sortie :

{
  "123456": {
    "id": "123456",
    "properties": {
      "name": "Acme Inc",
      "domain": "acme.com",
      "industry": "Technology",
      "description": "Leading tech company building developer tools",
      "annualrevenue": "5000000",
      "numberofemployees": "75"
    }
  }
}

Branchez company_data dans un JSON Path Extractor pour récupérer la description, puis dans un node LLM pour rédiger l’email.

Exemple 2 : Récupérer une entreprise et ses deals ouverts

Vous voulez construire un instantané de compte qui liste l’entreprise et chaque deal qui lui est rattaché.

Configuration :

• Company ID(s) : 123456
• Properties : name, domain, industry, lifecyclestage
• Associations : deals, contacts

La sortie comprend un bloc properties ainsi qu’un bloc associations listant les IDs des deals et contacts liés, que vous pourrez résoudre dans des nodes suivants.

Exemple 3 : Résoudre en masse une liste d’IDs depuis un node en amont

Combinez avec un node qui produit plusieurs IDs HubSpot (par exemple un filtre de liste ou un lecteur CSV). Branchez la sortie du node amont sur le port d’entrée company_ids et laissez le textarea vide. Configurez Properties sur les colonnes nécessaires, puis bouclez sur le résultat pour le traitement en aval.

Problèmes courants

Le node échoue avec Company ID(s) are required

Cause : L’entrée company_ids est vide et le textarea ne contient aucune valeur.

Solution : Saisissez des IDs dans le champ Company ID(s) ou branchez un node en amont sur le port d’entrée company_ids qui produit une valeur non vide à l’exécution.

Le node échoue avec HubSpot integration is required

Cause : Aucune intégration HubSpot n’est sélectionnée sur le node, ou l’intégration enregistrée a été supprimée depuis Settings > Integrations.

Solution : Ouvrez les paramètres du node et choisissez une intégration HubSpot dans le champ HubSpot Integration. Reconnectez HubSpot depuis Settings > Integrations si la liste déroulante est vide.

Une propriété attendue est absente de la sortie

Cause : La propriété ne figure pas dans la liste Properties, ou son nom interne HubSpot ne correspond pas à ce qui a été saisi.

Solution : Ajoutez la propriété à la liste. Pour les propriétés personnalisées, utilisez le nom interne exact tel que défini dans HubSpot (minuscules, underscores), pas le libellé d’affichage.

Un ID parmi plusieurs ne renvoie rien

Cause : L’entreprise concernée a été supprimée, archivée ou n’est pas visible pour les scopes de l’intégration.

Solution : Vérifiez que l’ID existe toujours dans HubSpot et que votre intégration a accès à l’unité propriétaire de l’entreprise. Les autres IDs du même appel sont résolus normalement.

Bonnes pratiques

Nodes associés