> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://katalyz.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# HubSpot — mapping des champs & objets personnalisés

Cet article explique comment les propriétés Katalyz se mappent aux propriétés standard de HubSpot et aux objets personnalisés.

Pour la référence principale du mapping des champs, consultez [Mapping des champs & synchronisation HubSpot](https://katalyz.crisp.help/fr/article/mapping-et-synchronisation-des-champs-crm-hubspot-salesforce-q9h678/) — c'est l'article admin complet. Celui-ci se concentre sur les spécificités côté intégration.

## Objets HubSpot pris en charge

* **Contacts**
* **Entreprises**
* **Transactions**
* **Objets HubSpot personnalisés** (si votre portail en utilise)
* **Tâches**
* **Événements de timeline**

## Mapper des objets HubSpot personnalisés

Mapper un objet HubSpot personnalisé suit le **même flux que le mapping de n'importe quel objet standard** — utilisez l'interface de mapping des champs documentée dans [Mapping des champs & synchronisation HubSpot](https://katalyz.crisp.help/fr/article/mapping-et-synchronisation-des-champs-crm-hubspot-salesforce-q9h678/). Les objets personnalisés apparaissent dans le sélecteur à condition que votre installation HubSpot ait accordé les scopes `crm.schemas.custom.read` / `crm.objects.custom.read|write` (voir [Connecter HubSpot](https://katalyz.crisp.help/fr/article/connecter-hubspot-ihvxea/)).

## Mappings préconfigurés

Il n'existe **aucun mapping par défaut prêt à l'emploi**. Après avoir connecté HubSpot, vous partez d'une page blanche — chaque mapping est créé explicitement par vos soins via l'interface de mapping des champs.

## Importer les champs depuis HubSpot — recommandé

Plutôt que de créer chaque champ Katalyz à la main puis de le mapper ensuite à une propriété HubSpot, **importez directement les champs depuis HubSpot**. C'est la voie recommandée pour la plupart des cas.

Concrètement, quand vous importez une propriété HubSpot :

* Katalyz **recrée la même structure de champ** côté Katalyz — même type (texte, nombre, date, liste déroulante…), mêmes **options** pour les listes déroulantes (valeurs et libellés alignés), même formatage (devise, datetime, etc.).
* La **correspondance est créée automatiquement** — pas besoin de re-pointer le champ Katalyz vers la bonne propriété HubSpot.
* La structure reste **conservée** : si vous ajoutez plus tard une option à un menu déroulant côté HubSpot, l'import garde les deux côtés alignés.

Avantages :

* **Moins d'erreurs** — pas de mismatch de type ou d'options qui font échouer silencieusement la sync (voir le tableau de compatibilité plus bas).
* **Plus rapide** — un seul geste par champ au lieu de deux (création + mapping).
* **Plus fiable** — la source de vérité de la structure du champ reste HubSpot ; Katalyz miroite.

Quand préférer la création manuelle ? Pour les champs **propres à Katalyz** qui n'existent pas (et n'ont pas vocation à exister) dans HubSpot — par exemple un champ purement interne à la collaboration dans l'Espace.

## Compatibilité des types de champs

| Type de champ Katalyz | Types HubSpot compatibles |
| ---- |
| **Texte une ligne** | Texte une ligne, Sélection unique |
| **Texte multi-lignes** | Texte multi-lignes |
| **Nombre** | Nombre |
| **Devise** | Nombre (avec formatage devise) |
| **Date** | Sélecteur de date, Datetime |
| **Liste déroulante** | Liste déroulante (les valeurs doivent correspondre) |
| **Téléphone** | Numéro de téléphone |

Un mapping entre types incompatibles fait échouer silencieusement la synchronisation pour ce champ.

## Articles liés
* [Mapping des champs & synchronisation HubSpot](https://katalyz.crisp.help/fr/article/mapping-et-synchronisation-des-champs-crm-hubspot-salesforce-q9h678/)
* [Créer des propriétés personnalisées](https://katalyz.crisp.help/fr/article/creer-des-proprietes-personnalisees-mq9u36/)
* [Connecter HubSpot](https://katalyz.crisp.help/fr/article/connecter-hubspot-ihvxea/)