> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # API du CRM | Entreprises > Les fiches d'informations d'entreprise stockent des données sur les entreprises. Les points de terminaison des entreprises vous permettent de gérer ces données et de les synchroniser entre HubSpot et d'autres systèmes.  > **[Run in Postman](https://app.getpostman.com/run-collection/caf616003f52c955b5f6)** > **Exigences de portée** # Entreprises Dans HubSpot, les entreprises stockent des informations sur les organisations qui interagissent avec elles. Les points de terminaison des entreprises vous permettent de créer et de gérer des fiches d'informations d'entreprise ainsi que de synchroniser des données d'entreprise entre HubSpot et d'autres systèmes. Découvrez-en davantage sur les API d'objets, de fiches d'informations, de propriétés et d'associations dans le [guide Comprendre le CRM](https://developers.hubspot.fr/docs/guides/crm/understanding-the-crm). Pour plus d'informations générales sur les objets et les fiches d'informations dans HubSpot, [découvrez comment gérer votre base de données CRM](https://knowledge.hubspot.com/get-started/manage-your-crm-database). ## Créer des entreprises Pour créer de nouvelles entreprises, effectuez une requête `POST` à `/crm/v3/objects/companies`. Dans votre requête, incluez les données de votre entreprise dans un objet de propriétés. Vous pouvez également ajouter un objet d'association pour associer votre nouvelle entreprise à des fiches d'informations existantes (par exemple, des contacts ou des transactions) ou à des activités (par exemple, des réunions ou des notes). ### Propriétés Les détails de l'entreprise sont stockés dans des propriétés d'entreprise. Il existe des [propriétés d'entreprise HubSpot par défaut](https://knowledge.hubspot.com/properties/hubspot-crm-default-company-properties), mais vous pouvez également [créer des propriétés personnalisées](https://knowledge.hubspot.com/properties/create-and-edit-properties). Lorsque vous créez une nouvelle entreprise, vous devez inclure au moins une des propriétés suivantes dans votre requête : `name` ou `domain`. Il est recommandé de toujours inclure `domain`, car les noms de domaine constituent le [principal identifiant unique](https://knowledge.hubspot.com/records/deduplication-of-records#automatic-deduplication-in-hubspot) pour éviter les entreprises en double dans HubSpot. Si une entreprise possède [plusieurs domaines](https://knowledge.hubspot.com/records/add-multiple-domain-names-to-a-company-record), vous pouvez les ajouter via l'API en utilisant le champ `hs_additional_domains` avec des points-virgules séparant chaque domaine. Par exemple : `"hs_additional_domains" : "domain.com; domain2.com; domain3.com"`. Pour afficher toutes les propriétés disponibles, vous pouvez récupérer une liste des propriétés d'entreprise de votre compte en effectuant une requête `GET` à `/crm/v3/properties/companies`. Découvrez-en davantage sur l'[API des propriétés](https://developers.hubspot.fr/docs/api-reference/crm-properties-v3/guide.md). > [!WARNING] > > ### Remarque: > > si vous avez inclus `lifecyclestage` dans votre requête, les valeurs doivent faire référence au nom interne de la phase du cycle de vie. Les noms internes des phases par défaut sont des valeurs textuelles et ne changent pas, même si vous modifiez le [libellé](https://knowledge.hubspot.com/properties/create-and-edit-properties#:~:text=the%20properties%20settings.-,Label/Name%3A,-enter%20a%20unique) de la phase (par exemple, `subscriber` ou `marketingqualifiedlead`). Les noms internes des [phases personnalisées](https://knowledge.hubspot.com/object-settings/create-and-customize-lifecycle-stages) sont des valeurs numériques. Vous pouvez trouver l'ID interne d'une phase dans vos [paramètres de phase du cycle de vie](https://knowledge.hubspot.com/object-settings/create-and-customize-lifecycle-stages#:~:text=To%20edit%20a%20lifecycle%20stage%2C%20hover%20over%20the%20stage%20and%20click%20Edit.%20In%20the%20right%20panel%2C%20edit%20the%20Stage%20name%2C%20then%20click%20Edit%20lifecycle%20stage%20to%20confirm.%20Click%20the%20code%20codcode%20icon%20to%20view%20the%20stage%27s%20internal%20ID%2C%20which%20is%20used%20by%20integrations%20and%20APIs.) ou en récupérant la propriété de phase du cycle de vie via l'API. Par exemple, pour créer une nouvelle entreprise, votre requête peut ressembler à ce qui suit : **JSON** ```json theme={null} ///Example request body { "properties": { "name": "HubSpot", "domain": "hubspot.com", "city": "Cambridge", "industry": "Technology", "phone": "555-555-555", "state": "Massachusetts", "lifecyclestage": "51439524" } } ``` ### Associations Lorsque vous créez une nouvelle entreprise, vous pouvez également associer l'entreprise à des [fiches d'informations](https://knowledge.hubspot.com/records/associate-records) ou [activités](https://knowledge.hubspot.com/records/associate-activities-with-records) existantes dans un objet d'associations. Par exemple, pour associer une nouvelle entreprise à un contact et une adresse e-mail existants, votre requête ressemblerait à ce qui suit : **JSON** ```json theme={null} ///Example request body { "properties": { "name": "HubSpot", "domain": "hubspot.com", "city": "Cambridge", "industry": "Technology", "phone": "555-555-555", "state": "Massachusetts", "lifecyclestage": "51439524" }, "associations": [ { "to": { "id": 101 }, "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 280 } ] }, { "to": { "id": 556677 }, "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 185 } ] } ] } ``` Dans l'objet d'association, vous devez ajouter les éléments suivants : | Paramètre | Description | | - | - | | `to` | La fiche d'informations ou l'activité à laquelle vous souhaitez associer l'entreprise, en fonction de sa valeur unique `id`. | | `types` | Le type d'association entre l'entreprise et la fiche d'informations/l'activité. Inclut la `associationCategory` et le `associationTypeId`. Les ID de types d'association par défaut sont répertoriés [ici](https://developers.hubspot.fr/docs/api-reference/crm-associations-v4/guide.md#association-type-id-values), ou vous pouvez récupérer la valeur des types d'associations personnalisés (c'est-à-dire les libellés) via l'[API des associations](https://developers.hubspot.fr/docs/api-reference/crm-associations-v4/guide.md#retrieve-association-types). | ## Récupérer des entreprises Vous pouvez récupérer des entreprises individuellement ou par lots. * Pour récupérer une entreprise individuelle, effectuez une requête `GET` à `/crm/v3/objects/companies/{companyId}`. * Pour demander une liste de toutes les entreprises, effectuez une requête `GET` à `/crm/v3/objects/companies`. Pour ces points de terminaison, vous pouvez inclure les paramètres suivants dans l'URL de la requête : | Paramètre | Description | | - | - | | `properties` | Une liste séparée par des virgules des propriétés à renvoyer dans la réponse. Si l'entreprise demandée n'a pas de valeur pour une propriété, elle n'apparaîtra pas dans la réponse. | | `propertiesWithHistory` | Une liste séparée par des virgules des propriétés actuelles et historiques à renvoyer dans la réponse. Si l'entreprise demandée n'a pas de valeur pour une propriété, elle n'apparaîtra pas dans la réponse. | | `associations` | Une liste séparée par des virgules des objets pour lesquels récupérer les ID associés. Les associations spécifiées qui n'existent pas ne seront pas renvoyées dans la réponse. Découvrez-en davantage sur l'[API des associations.](https://developers.hubspot.fr/docs/api-reference/crm-associations-v4/guide.md) | * Pour récupérer un lot d'entreprises spécifiques par ID de fiche d'informations ou selon une [propriété d'identifiant unique personnalisée](https://developers.hubspot.fr/docs/api-reference/crm-properties-v3/guide.md#create-unique-identifier-properties), effectuez une requête `POST` à `crm/v3/objects/companies/batch/read`. Le point de terminaison du lot ne peut pas récupérer les associations. Découvrez comment lire par lots les associations avec l'API [des associations](https://developers.hubspot.fr/docs/api-reference/crm-associations-v4/guide.md). Pour le point de terminaison de lecture par lot, vous pouvez également utiliser le paramètre `idProperty` facultatif pour récupérer les entreprises en fonction d'une [propriété d'identifiant unique](https://developers.hubspot.fr/docs/api-reference/crm-properties-v3/guide.md#create-unique-identifier-properties) personnalisée. Par défaut, les valeurs d'`id` dans la requête font référence à l'ID de fiche d'informations (`hs_object_id`), de sorte que le paramètre `idProperty` n'est pas requis lors de la récupération par ID de fiche d'informations. Pour utiliser une propriété de valeur unique personnalisée pour récupérer des entreprises, vous devez inclure le paramètre `idProperty`. Par exemple, pour récupérer un lot d'entreprises, votre requête peut ressembler à ce qui suit : ```json theme={null} ///Example request body with record ID { "properties": ["name", "domain"], "inputs": [ { "id": "56789" }, { "id": "23456" } ] } ``` ```json theme={null} ///Example request body with a unique value property { "properties": ["name", "domain"], "idProperty": "uniquepropertyexample", "inputs": [ { "id": "abc" }, { "id": "def" } ] } ``` Pour récupérer des entreprises avec des valeurs actuelles et historiques pour une propriété, votre requête pourrait ressembler à : ```json theme={null} ///Example request body with record ID (current and historical values) { "propertiesWithHistory": ["name"], "inputs": [ { "id": "56789" }, { "id": "23456" } ] } ``` ## Mettre à jour des entreprises Vous pouvez mettre à jour des entreprises individuellement ou par lots. Pour les entreprises existantes, l'ID de la fiche d'informations de l'entreprise est une valeur unique que vous pouvez utiliser pour mettre à jour l'entreprise via l'API. Pour mettre à jour une entreprise individuelle avec son ID d'entreprise, effectuez une requête `PATCH` à `/crm/v3/objects/companies/{companyId}` et incluez les données que vous souhaitez mettre à jour. > [!WARNING] > > ### Remarque: > > Si vous mettez à jour la propriété `lifecyclestage`, vous ne pouvez qu'avancer la valeur dans l'ordre des étapes. Pour rétrograder la phase du cycle de vie, vous devrez d'abord effacer la valeur de phase du cycle de vie existante de la fiche d'informations. La valeur peut être [effacée manuellement](https://knowledge.hubspot.com/records/update-a-property-value-for-a-record), ou automatiquement via un [workflow](https://knowledge.hubspot.com/records/change-record-lifecycle-stages-in-bulk) ou une intégration qui synchronise les données de contact. ### Associer des entreprises existantes à des fiches d'informations et activités Pour associer une entreprise à d'autres fiches d'informations de CRM ou à une activité, effectuez une requête `PUT` à `/crm/v3/objects/companies/{companyId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}`. > [!NOTE] > > Pour récupérer la valeur `associationTypeId`, reportez-vous à [cette liste](https://developers.hubspot.fr/docs/api-reference/crm-associations-v4/guide.md#association-type-id-values) de valeurs par défaut ou effectuez une requête `GET` à `/crm/v4/associations/{fromObjectType}/{toObjectType}/labels`. Découvrez-en davantage sur l'association de fiches d'informations avec l'[API des associations](https://developers.hubspot.fr/docs/api-reference/crm-associations-v4/guide.md). ### Supprimer une association Pour supprimer une association entre une entreprise et une fiche d'informations ou une activité, effectuez une requête `DELETE` à l'URL suivante : `/crm/v3/objects/companies/{companyId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}`. ## Épingler une activité à une fiche d'informations d'une entreprise Vous pouvez épingler une activité à une fiche d'informations d'une entreprise via l'API en incluant le champ `hs_pinned_engagement_id` dans votre requête. Dans le champ, incluez l'`id` de l'activité à épingler, qui peut être récupéré via les [API d'engagement](https://developers.hubspot.fr/docs/api-reference/overview.md). Vous pouvez épingler une activité par fiche d'informations, et l'activité doit déjà être associée à l'entreprise avant l'épinglage. Pour définir ou mettre à jour l'activité épinglée d'une entreprise, votre requête peut ressembler à : ```json theme={null} ///Example request body PATCH /crm/v3/objects/companies/{companyId} { "properties": { "hs_pinned_engagement_id": 123456789 } } ``` Vous pouvez également créer une entreprise, l'associer à une activité existante et épingler l'activité dans la même requête. Par exemple : ```json theme={null} ///Example request body POST /crm/v3/objects/companies { "properties": { "domain": "example.com", "name": "Example Company", "hs_pinned_engagement_id": 123456789 }, "associations": [ { "to": { "id": 123456789 }, "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 189 } ] } ] } ``` ## Supprimer des entreprises Vous pouvez supprimer des entreprises individuellement ou par lots, ce qui placera l'entreprise dans la corbeille dans HubSpot. Vous pourrez ensuite [restaurer l'entreprise dans HubSpot](https://knowledge.hubspot.com/records/restore-deleted-records). Pour supprimer une entreprise avec son ID, effectuez une requête `DELETE` à `/crm/v3/objects/companies/{companyId}`. Pour en savoir plus sur la suppression d'entreprises par lots, consultez la [documentation de référence](https://developers.hubspot.fr/docs/api-reference/crm-companies-v3/guide.md).