> ## 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 | Imports > Les imports sont utilisés pour remplir un compte HubSpot avec des données d'objets qui peuvent être utilisées avec les outils de vente, de marketing et de service client. > **[Run in Postman](https://app.getpostman.com/run-collection/f30b00bcfdc29170b2e8)** > **Exigences de portée** # Imports Utilisez l'API d'import pour importer des fiches d'informations et des activités du CRM dans votre compte HubSpot, comme des contacts, des entreprises et des notes. Une fois l'import terminé, vous pouvez accéder aux fiches d'informations et aux activités et les mettre à jour via les différents points de terminaison de l'API du CRM, y compris l'[API des contacts](https://developers.hubspot.fr/docs/guides/crm/understanding-the-crm), l'[API des associations](https://developers.hubspot.fr/docs/api-reference/crm-associations-v4/guide.md) et les [API des engagements.](https://developers.hubspot.fr/docs/api-reference/overview.md) Vous pouvez également [importer des fiches d'informations et des activités à l'aide de l'outil d'import guidé dans HubSpot](https://knowledge.hubspot.com/fr/import-and-export/import-objects). Avant de commencer l'import, découvrez-en davantage sur : * [Conditions des fichiers](https://knowledge.hubspot.com/fr/import-and-export/set-up-your-import-file#file-requirements-and-technical-limits) * [Les propriétés requises pour les imports de fiches d'informations et d'activités](https://knowledge.hubspot.com/fr/import-and-export/set-up-your-import-file#required-properties) * [Les propriétés requises pour les importations de participants à des événements marketing](https://knowledge.hubspot.com/fr/integrations/import-marketing-event-participants#prepare-your-import-file) > [!WARNING] > > ### Remarque : > > Pour créer des événements personnalisés ou associer des événements à des fiches d'informations, utilisez l'[API d'événements personnalisés](https://developers.hubspot.fr/docs/api-reference/events-send-event-completions-v3/guide.md) au lieu d'importer. ## Démarrer un import Vous pouvez commencer un import en effectuant une requête `POST` à `/crm/v3/imports` avec un corps de requête qui spécifie comment mapper les colonnes de votre fichier d'import aux propriétés associées dans HubSpot. Les imports d'API sont envoyés sous forme de requêtes de données de formulaire, le corps de la requête contenant les champs suivants : * [importRequest](#format-the-importrequest-data) : un champ de texte qui contient le JSON de requête. * [files](#map-file-columns-to-hubspot-properties) : un champ de fichier qui contient le fichier d'import. Pour l'en-tête de requête, ajoutez un en-tête `Content-Type` avec une valeur `multipart/form-data`. La capture d'écran ci-dessous illustre ce à quoi pourrait ressembler votre requête lorsque vous utilisez une application telle que Postman : ![postman-import-request-no-response0](https://www.hubspot.fr/hubfs/Knowledge_Base_2021/Developer/postman-import-request-no-response0.png) ### Formater les données importRequest Dans votre requête, définissez les détails du fichier d'import, y compris le mappage des colonnes de la feuille de calcul avec les données HubSpot. Votre requête doit inclure les champs suivants : * **name** : nom de l'import. Dans HubSpot, il s'agit du nom [affiché dans l'outil d'import](https://knowledge.hubspot.com/fr/import-and-export/view-and-analyze-previous-imports) ainsi que du nom que vous pouvez mentionner dans d'autres outils, tels que des listes. * **importOperations** : un champ facultatif utilisé pour indiquer si l'import doit [créer et mettre à jour, uniquement créer ou uniquement mettre à jour des fiches d'informations](https://knowledge.hubspot.com/fr/import-and-export/import-objects#choose-how-to-import) pour un objet ou une activité donné. Incluez l'élément `objectTypeId` pour l'objet/l'activité et si vous souhaitez `UPSERT` (créer et mettre à jour), `CREATE` ou `UPDATE` des fiches d'informations. Par exemple, le champ ressemblerait à ceci dans votre requête : `"importOperations": {"0-1": "CREATE"}`. Si vous n'incluez pas ce champ, la valeur par défaut utilisée pour l'import sera `UPSERT`. * **dateFormat** : le format des dates incluses dans le fichier. Par défaut, cette valeur est définie sur `MONTH_DAY_YEAR`, mais vous pouvez également utiliser `DAY_MONTH_YEAR` ou `YEAR_MONTH_DAY`. * **marketableContactImport** : un champ facultatif pour indiquer le [statut marketing](https://knowledge.hubspot.com/fr/records/marketing-contacts) des contacts dans votre fichier d'import. Ceci est utilisé uniquement lors de l'import de contacts dans des comptes qui ont [accès aux contacts marketing](https://knowledge.hubspot.com/fr/records/marketing-contacts#check-your-access-to-marketing-contacts). Pour définir les contacts dans le fichier comme marketing, utilisez la valeur `true`. Pour définir les contacts dans le fichier comme non marketing, utilisez la valeur `false`. * **createContactListFromImport** : un champ facultatif pour [créer une liste statique de contacts](https://knowledge.hubspot.com/fr/import-and-export/import-objects#create-list-from-import) à partir de votre import. Pour créer une liste à partir de votre fichier, utilisez la valeur `true`. * **files** : un tableau qui contient des informations sur votre fichier d'import. * **fileName** : le nom du fichier d'import. * **fileFormat** : le format du fichier d'import. Pour les fichiers CSV, utilisez la valeur `CSV`. Pour les fichiers Excel, utilisez la valeur `SPREADSHEET`. * **fileImportPage** : contient le tableau `columnMappings` requis pour mapper les données de votre fichier d'import aux données HubSpot. Découvrez-en davantage sur le mappage des colonnes ci-dessous. ### Mapper des colonnes de fichiers à des propriétés HubSpot Dans le tableau `columnMappings`, incluez une entrée pour chaque colonne de votre fichier d'import, en respectant l'ordre des en-têtes de colonnes de votre feuille de calcul. Pour chaque colonne, ajoutez les champs suivants : * **columnObjectTypeId :** le nom ou la valeur `objectTypeId` de l'objet ou de l'activité auquel/à laquelle les données appartiennent. Consultez [cet article](https://developers.hubspot.fr/docs/guides/crm/understanding-the-crm#object-type-id) pour une liste complète des valeurs `objectTypeId`. * **columnName** : le nom de l'en-tête de colonne. Il doit correspondre exactement au nom de l'en-tête de colonne dans le fichier. * **propertyName** : le nom interne de la HubSpot vers laquelle les données seront mappées. Pour la colonne commune dans [les imports multi-fichiers](#import-multiple-files), `propertyName` doit être `null` lorsque le champ `toColumnObjectTypeId` est utilisé. * **columnType** : utilisé pour spécifier qu'une colonne contient une [propriété d'identifiant unique](https://knowledge.hubspot.com/fr/import-and-export/understand-the-import-tool#unique-identifiers). En fonction de la propriété et de l'objectif de l'import, utilisez l'une des valeurs suivantes : * **HUBSPOT\_OBJECT\_ID** : l'identifiant d'une fiche d'informations. Par exemple, votre fichier d'import de contacts peut contenir un *ID de fiche d'informations* qui stocke l'ID de l'entreprise à laquelle vous souhaitez associer les contacts. * **HUBSPOT\_ALTERNATE\_ID** : un identifiant unique autre que l'ID de fiche d'informations. Par exemple, votre fichier d'import de contacts peut contenir une colonne *Adresse e-mail* qui stocke les adresses e-mail des contacts. * **FLEXIBLE\_ASSOCIATION\_LABEL** : incluez ce type de colonne pour indiquer que la colonne contient des libellés d'associations. * **ASSOCIATION\_KEYS** : pour les imports d'associations d'objets identiques uniquement, incluez ce type de colonne pour l'identifiant unique des mêmes fiches d'informations d'objets que vous associez. Par exemple, dans votre requête d'import d'associations de contacts, la colonne *\[ID de fiche d'informations/adresse e-mail]* du contact associé doit avoir un élément `columnType` de `ASSOCIATION_KEYS`. Découvrez-en davantage sur [la configuration de votre fichier d'import pour l'import d'associations d'objets identiques](https://knowledge.hubspot.com/fr/import-and-export/set-up-your-import-file#same-object-association-imports). * **toColumnObjectTypeId** : pour les imports de [plusieurs fichiers](#import-multiple-files) ou objets, le nom ou `objectTypeId` de l'objet auquel appartient la propriété de [colonne commune](https://knowledge.hubspot.com/fr/import-and-export/set-up-your-import-file#import-associations-in-two-files) ou le libellé d'association. Incluez ce champ pour la propriété de colonne commune dans le fichier de l'objet auquel la propriété n'appartient pas. Par exemple, si vous associez des contacts et des entreprises dans deux fichiers avec la propriété de contact *Adresse e-mail* comme colonne commune, incluez `toColumnObjectTypeId` pour la colonne *Adresse e-mail* dans le fichier de l'entreprise. * **foreignKeyType** : pour les [imports multi-fichiers](#import-multiple-files) uniquement, le type d'association que la colonne commune doit utiliser, spécifié par `associationTypeId` et `associationCategory`. Incluez ce champ pour la propriété de colonne commune dans le fichier de l'objet auquel la propriété n'appartient pas. Par exemple, si vous associez des contacts et des entreprises dans deux fichiers avec la propriété de contact *Adresse e-mail* comme colonne commune, incluez `foreignKeyType` pour la colonne *Adresse e-mail* dans le fichier de l'entreprise. * **associationIdentifierColumn** : pour les [imports multi-fichiers](#import-multiple-files) uniquement, indique la propriété utilisée dans la colonne commune pour associer les fiches d'informations. Incluez ce champ pour la propriété de colonne commune dans le fichier de l'objet auquel la propriété appartient. Par exemple, si vous associez des contacts et des entreprises dans deux fichiers avec la propriété de contact *Adresse e-mail* comme colonne commune, définissez `associationIdentifierColumn` sur `true` pour la colonne *E-mail dans le* fichier de contact. ## Importer un fichier avec un objet Voici un exemple de corps de requête pour l'import d'un fichier pour créer des contacts : ```json example.json theme={null} // Example POST to https://api.hubspot.com/crm/v3/imports // Content-Type header set to multipart/form-data { "name": "November Marketing Event Leads", "importOperations": { "0-1": "CREATE" }, "dateFormat": "DAY_MONTH_YEAR", "files": [ { "fileName": "Nov-event-leads.csv", "fileFormat": "CSV", "fileImportPage": { "hasHeader": true, "columnMappings": [ { "columnObjectTypeId": "0-1", "columnName": "First Name", "propertyName": "firstname" }, { "columnObjectTypeId": "0-1", "columnName": "Last Name", "propertyName": "lastname" }, { "columnObjectTypeId": "0-1", "columnName": "Email", "propertyName": "email", "columnType": "HUBSPOT_ALTERNATE_ID" } ] } } ] } ``` ```python example.py theme={null} # This example a local file named 'test_import.csv' # This file contains a list of contact records to import. import requests import json import os url = "https://api.hubapi.com/crm/v3/imports" YOUR_ACCESS_TOKEN = 'xxxxxxx'; # Content-Type header will be set automatically by the requests library headers = { 'authorization': 'Bearer %s' % YOUR_ACCESS_TOKEN } data = { "name": "November Marketing Event Leads", "importOperations": { "0-1": "CREATE" }, "dateFormat": "DAY_MONTH_YEAR", "files": [ { "fileName": "Nov-event-leads.csv", "fileFormat": "CSV", "fileImportPage": { "hasHeader": True, "columnMappings": [ { "columnObjectTypeId": "0-1", "columnName": "First Name", "propertyName": "firstname" }, { "columnObjectTypeId": "0-1", "columnName": "Last Name", "propertyName": "lastname" }, { "columnObjectTypeId": "0-1", "columnName": "Email", "propertyName": "email", "columnType": "HUBSPOT_ALTERNATE_ID" } ] } } ] } datastring = json.dumps(data) payload = {"importRequest": datastring} current_dir = os.path.dirname(__file__) relative_path = "./test_import.csv" absolute_file_path = os.path.join(current_dir, relative_path) files = [ ('files', open(absolute_file_path, 'rb')) ] print(files) response = requests.request("POST", url, data=payload, files=files, headers=headers) print(response.text.encode('utf8')) print(response.status_code) ``` ```bash example.sh theme={null} # Using this endpoint requires using sending multi-part form encoded data. Here is an example curl request: # importing a file named import_file.csv # create a variable for the importRequest JSON myJSON=$(cat < [!WARNING] > > ### Remarque : > > Lors de la récupération des imports, la réponse inclura uniquement les imports effectués par la même application. Les imports effectués dans HubSpot ou via une autre application ne seront pas renvoyés. ## Annuler l'import Pour annuler un import actif, effectuez une requête `POST` à `/crm/v3/imports/{importId}/cancel`. ## Afficher et résoudre les erreurs d'import Pour afficher les erreurs pour un import spécifique, faites une requête `GET` à `/crm/v3/imports/{importId}/errors`. Découvrez comment résoudre [les erreurs d'import les plus courantes](https://knowledge.hubspot.com/fr/import-and-export/troubleshoot-import-errors). Pour les erreurs telles que *Nombre de colonnes incorrect,* *Impossible d'analyser le JSON* ou *Le texte/HTML 404 n'est pas accepté* : * Vérifiez qu'il existe un en-tête de colonne pour chaque colonne de votre fichier et que le corps de la requête contient une entrée `columnMapping` pour chaque colonne. Les critères suivants doivent être remplis : * L'ordre des colonnes dans le corps de la requête et le fichier d'import doit correspondre. Si l'ordre des colonnes ne correspond pas, le système tentera de réorganiser automatiquement mais échouera, ce qui entraînera une erreur au démarrage de l'import. * Chaque colonne doit être mappée. Si aucune colonne n'est mappée, la requête d'import peut quand même aboutir, mais entraînera l'erreur *Nombre de colonnes incorrect* au démarrage de l'import. * Assurez-vous que le nom du fichier et le champ `fileName` de votre JSON de requête correspondent et que vous avez inclus l'extension de fichier dans le champ `fileName`. Par exemple : *import\_name.csv.* * Vérifiez que votre en-tête comprend `Content-Type` avec une valeur `multipart/form-data`. ```json example.json theme={null} Example POST URL: https://api.hubapi.com/crm/v3/imports? Example importRequest JSON data: This example contains 3 columns: - First name, mapped to the firstname contact property - Email, mapped to the email contact property - Company ID, which contains a list of company record IDs that the contact will be assocated with. { "name": "test_import", "files": [ { "fileName": "final_emails.csv", "fileImportPage": { "hasHeader": true, "columnMappings": [ { "ignored": false, "columnName": "First Name", "idColumnType": null, "propertyName": "firstname", "foreignKeyType": null, "columnObjectType": "CONTACT", "associationIdentifierColumn": false }, { "ignored": false, "columnName": "Email", "idColumnType": "HUBSPOT_ALTERNATE_ID", "propertyName": "email", "foreignKeyType": null, "columnObjectType": "CONTACT", "associationIdentifierColumn": false }, { "ignored": false, "columnName": "Company ID", "idColumnType": "HUBSPOT_OBJECT_ID", "propertyName": null, "foreignKeyType": { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 1 }, "columnObjectType": "CONTACT", "associationIdentifierColumn": false } ] } } ] } ``` ```python example.py theme={null} # This example a local file named 'final_emails.csv' # This file contains a list of contact records to import. # Each row in the file contains a column named "Company ID" that contains the companyId # that the contact should be associated with. import requests import json post_url = 'http://api.hubapi.com/crm/v3/imports?hapikey=4324...5432' importRequest = { "name": "test_import", "files": [ { "fileName": "final_emails.csv", "fileImportPage": { "hasHeader": True, "columnMappings": [ { "ignored": False, "columnName": "First Name", "idColumnType": None, "propertyName": "firstname", "foreignKeyType": None, "columnObjectType": "CONTACT", "associationIdentifierColumn": False }, { "ignored": False, "columnName": "Email", "idColumnType": "HUBSPOT_ALTERNATE_ID", "propertyName": "email", "foreignKeyType": None, "columnObjectType": "CONTACT", "associationIdentifierColumn": False }, { "ignored": False, "columnName": "Company ID", "idColumnType": "HUBSPOT_OBJECT_ID", "propertyName": None, "foreignKeyType": { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 1 }, "columnObjectType": "CONTACT", "associationIdentifierColumn": False } ] } } ] ``` ```php example.php theme={null} $csv_file, "importRequest" => $config_json ); $ch = curl_init(); @curl_setopt($ch, CURLOPT_POST, true); @curl_setopt($ch, CURLOPT_URL, $post_url); @curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data); $response = @curl_exec($ch); //Log the response from HubSpot as needed. $status_code = @curl_getinfo($ch, CURLINFO_HTTP_CODE); //Log the response status code @curl_close($ch); echo $status_code . " " . $response; ?> ``` ```bash example.sh theme={null} # Using this endpoint requires using sending multi-part form encoded data. Here is an example curl request: # importing a file named import_file.csv # create a variable for the importRequest JSON myJSON=$(cat < [!WARNING] > > ### Remarque : > > Si vous recevez une erreur, vérifiez s'il y a des en-têtes en double, tels que `Content-Type`. Cela peut se produire si vous utilisez Postman ou s'il est inclus dans l'en-tête de votre script Python. Supprimez le doublon avant de terminer la requête. ## Limites d'utilisation Lorsque vous utilisez l'API d'import, vous pouvez importer jusqu'à 80 millions de lignes par jour. Cependant, un fichier d'import est limité à 1 048 576 lignes ou 512 Mo, selon la première éventualité. Si votre requête dépasse la limite de lignes ou la taille maximale, HubSpot renverra une erreur HTTP 429. Lorsque vous approchez de ces limites, il est recommandé de diviser votre import en plusieurs requêtes.