Obtenir un template d'import avec tous les champs

Le fichier d'exemple proposé par HubSpot ne contient que deux ou trois colonnes. Où est le modèle avec la liste complète des champs que je peux importer ?

Ce modèle n'existe pas. HubSpot ne fournit que les propriétés obligatoires dans son fichier d'exemple. Pour obtenir la liste complète, exportez toutes les propriétés depuis Paramètres > Propriétés > Exporter toutes les propriétés, puis construisez votre ligne d'en-tête à partir de cette liste. C'est la seule méthode complète, et elle vous donne en plus le taux de remplissage de chaque propriété.

Pourquoi HubSpot génère un modèle contenant les champs attendus

La frustration est légitime, et la réponse de HubSpot est explicite. Les fichiers d'exemple comprennent uniquement les propriétés requises pour créer de nouvelles fiches. Il n'existe aucun mécanisme qui génère un fichier contenant toutes les colonnes possibles.

Ce que HubSpot fournit réellement, et qui est utile à connaître :

Un bouton de téléchargement d'un exemple de fichier, à l'étape de sélection des objets. Ses en-têtes sont au format <[OBJET] nom_interne>, par exemple . Ne modifiez pas ce format. C'est lui qui déclenche l'automappage. Et supprimez les lignes d'instructions avant d'importer.
Une bibliothèque de fichiers d'exemple téléchargeables, en xlsx et en csv, couvrant les contacts, entreprises, transactions, tickets, produits, tâches et appels, les associations entre objets de même type, et les imports multi-objets, y compris une variante avec libellés d'association. Ces fichiers contiennent les en-têtes obligatoires et quelques en-têtes supplémentaires. C'est ce qui se rapproche le plus d'un modèle enrichi.

Pour la liste exhaustive, la bonne méthode est l'export des propriétés. Le fichier obtenu contient, pour chaque propriété. Son nom, son nom interne, son type, sa description, son groupe, ses options le cas échéant, son créateur, ses utilisations et son taux de remplissage. Ce dernier point est précieux. Il vous dit immédiatement quelles propriétés sont réellement utilisées chez le client, et lesquelles ne servent à rien.

Un dernier point, souvent la vraie question derrière celle du modèle. Les valeurs des listes déroulantes. À l'import, une valeur doit correspondre au libellé ou à la valeur interne. Mais pour les listes livrées par HubSpot, comme la phase du cycle de vie ou le secteur d'activité, il faut la valeur interne ou le libellé anglais. Le libellé français ne fonctionne pas, et l'erreur renvoyée parle d'option d'énumération ambiguë.

En pratique, obtenir un modèle d'import complet

Obtenir la liste complète des propriétés d'un objet

Cliquez sur l'icône Paramètres, puis allez dans Propriétés.
En haut à droite, cliquez sur Exporter toutes les propriétés.
Cochez les objets qui vous intéressent.
Choisissez le format de fichier, puis lancez l'export.
Vous recevez le fichier par email et dans le centre de notifications. Si vous avez coché plusieurs objets, c'est une archive avec un fichier par objet.

Construire votre modèle d'import

Ouvrez le fichier exporté.
Filtrez sur les propriétés que vous voulez importer, en vous aidant de la colonne de taux de remplissage pour écarter celles que personne n'utilise.
Copiez la colonne des noms de propriétés et collez-la en transposé dans la ligne d'en-tête d'un fichier vierge.
Gardez le fichier exporté à côté. C'est votre dictionnaire de données pour tout le projet.

Retrouver les valeurs internes d'une liste déroulante

Allez dans Paramètres > Propriétés et trouvez la propriété.
Survolez-la et cliquez sur Modifier.
Ouvrez l'onglet du type de champ. Le tableau affiche chaque libellé avec sa valeur interne.

Pour une mise à jour, ne partez pas d'un modèle vierge

Exportez les fiches existantes avec la colonne ID de fiche d'informations et les propriétés à modifier, éditez le fichier, puis réimportez-le. Vous partez ainsi d'une clé fiable et de valeurs réelles, ce qui élimine la moitié des erreurs possibles.

À surveiller sur le modèle de fichier d'import HubSpot

Ne touchez pas au format des en-têtes du fichier d'exemple. Le format entre chevrons déclenche l'automappage. Le réécrire vous oblige à tout mapper à la main.
Supprimez les lignes d'instructions du fichier d'exemple avant l'import, sinon elles deviennent des fiches.
Le libellé français d'une liste déroulante HubSpot ne passe pas à l'import. Utilisez la valeur interne. C'est la cause la plus fréquente d'erreurs sur la phase du cycle de vie.
Une valeur interne n'est plus modifiable après enregistrement. Si elle a été mal nommée à la création, vous vivrez avec.
Le taux de remplissage est l'information la plus utile de l'export. Une propriété remplie à 2 % est une propriété à supprimer, pas à importer.
Un dictionnaire de données vaut mieux qu'un modèle. Le vrai livrable de cette démarche n'est pas un fichier d'en-têtes, c'est la liste des propriétés du portail, partagée avec le client. Elle sert à tous les imports suivants et à toutes les discussions de cadrage.

Quand nous contacter sur le modèle de fichier d'import HubSpot

Contactez Yuzu Corp si vous ne savez pas quelles propriétés utiliser pour votre import. L'export des propriétés donne la liste, pas la réponse. Le choix de ce qu'on importe et de ce qu'on laisse de côté est une décision de cadrage, et c'est souvent l'occasion de faire du ménage dans les propriétés inutilisées.

Sources et date de vérification

Contenu vérifié sur la documentation officielle le 18 août 2026 par Yuzu Corp, partenaire HubSpot Diamond.