> ## 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. # Retrieve errors for a specific import > Récupère les fiches d'informations d'erreurs détaillées pour une opération d'import spécifique, ce qui vous permet d'identifier et de corriger les problèmes liés aux fiches d'informations qui ont échoué pendant le traitement. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-03/crm-imports-v2026-03.json GET /crm/imports/2026-03/{importId}/errors openapi: 3.0.1 info: title: CRM Imports description: Basepom for all HubSpot Projects version: 2026-03 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic paths: /crm/imports/2026-03/{importId}/errors: get: tags: - Basic summary: Récupérer les erreurs pour un import spécifique description: >- Récupère les fiches d'informations d'erreurs détaillées pour une opération d'import spécifique, ce qui vous permet d'identifier et de corriger les problèmes liés aux fiches d'informations qui ont échoué pendant le traitement. operationId: >- get-/crm/imports/2026-03/{importId}/errors_/crm/imports/v3/{importId}/errors parameters: - name: importId in: path description: L'identifiant unique de l'import pour lequel récupérer les erreurs. required: true style: simple explode: false schema: type: integer format: int64 - name: after in: query description: >- Le jeton de curseur de pagination de la dernière ressource lue avec succès sera renvoyé en tant que propriété JSON `paging.next.after` d'une réponse paginée contenant plus de résultats. required: false style: form explode: true schema: type: string - name: includeErrorMessage in: query description: >- Un booléen indiquant s'il faut inclure des messages d'erreur détaillés dans la réponse. required: false style: form explode: true schema: type: boolean - name: includeRowData in: query description: >- Un booléen indiquant s'il faut inclure les données de ligne associées à chaque erreur dans la réponse. required: false style: form explode: true schema: type: boolean - name: limit in: query description: Le nombre maximum de résultats à afficher par page. required: false style: form explode: true schema: type: integer format: int32 responses: '200': description: successful operation content: application/json: schema: $ref: >- #/components/schemas/CollectionResponsePublicImportErrorForwardPaging default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.import components: schemas: CollectionResponsePublicImportErrorForwardPaging: required: - results type: object properties: paging: $ref: '#/components/schemas/ForwardPaging' results: type: array description: >- Un tableau d'erreurs d'importation publiques, chacune représentée par un objet PublicImportError. items: $ref: '#/components/schemas/PublicImportError' ForwardPaging: type: object properties: next: $ref: '#/components/schemas/NextPage' description: "Informations de pagination pour une pagination unidirectionnelle. Contient la référence de la page suivante lorsque d'autres résultats sont disponibles\_; omis ou vide sur la dernière page." PublicImportError: required: - createdAt - errorType - id - sourceData type: object properties: createdAt: type: integer description: >- L'horodatage en millisecondes epoch à laquelle cette erreur a été enregistrée. format: int64 errorMessage: type: string description: Un message d'erreur lisible par l'utilisateur. errorType: type: string description: >- La classification des problèmes rencontrés lors du traitement des imports. enum: - AMBIGUOUS_ENUMERATION_OPTION - ASSOCIATION_LABEL_NOT_FOUND - ASSOCIATION_LIMIT_EXCEEDED - ASSOCIATION_RECORD_NOT_FOUND - COLUMN_TOO_LARGE - COULD_NOT_FIND_BUSINESS_UNIT - COULD_NOT_FIND_OWNER - COULD_NOT_PARSE_DATE - COULD_NOT_PARSE_NUMBER - COULD_NOT_PARSE_ROW - COULD_NOT_PARSE_TERM - CREATE_ONLY_IMPORT - DUPLICATE_ALTERNATE_ID - DUPLICATE_ASSOCIATION_ID - DUPLICATE_EVENT - DUPLICATE_OBJECT_ID - DUPLICATE_RECORD_ID - DUPLICATE_ROW_CONTENT - DUPLICATE_UNIQUE_CREATION_KEY - DUPLICATE_UNIQUE_PROPERTY_VALUE - FAILED_TO_CREATE_ASSOCIATION - FAILED_TO_FIND_RECORD_FOR_ASSOCIATIONS - FAILED_TO_OPT_OUT_CONTACT - FAILED_TO_PROCESS_OBJECT_WITH_EMPTY_PROPERTY_VALUES - FAILED_VALIDATION - FILE_NOT_FOUND - GDPR_BLACKLISTED_EMAIL - INCORRECT_NUMBER_OF_COLUMNS - INVALID_ALTERNATE_ID - INVALID_ASSOCIATION_IDENTIFIER - INVALID_ASSOCIATION_KEY - INVALID_COLUMN_CONFIGURATION - INVALID_CUSTOM_PROPERTY_VALIDATION - INVALID_DOMAIN - INVALID_EMAIL - INVALID_ENUM_FILE_ID_OR_URL - INVALID_ENUMERATION_OPTION - INVALID_EVENT - INVALID_EVENT_TIMESTAMP - INVALID_FILE_TYPE - INVALID_NUMBER_SIZE - INVALID_OBJECT_ID - INVALID_PROPERTY_VALUE_FORMAT - INVALID_RECORD_ID - INVALID_REQUIRED_PROPERTY - INVALID_SHEET_COUNT - INVALID_SPREADSHEET - LIMIT_EXCEEDED - LINE_ITEM_MULTIPLE_PARENTS_IN_ROW - MANY_ERRORS_IN_ROW - MISSING_EVENT_DEFINITION - MISSING_EVENT_TIMESTAMP - MISSING_OBJECT_DEFINITION - MISSING_REQUIRED_PROPERTY - MULTIPLE_COMPANIES_WITH_THIS_DOMAIN - MULTIPLE_OWNERS_FOUND - NO_OBJECT_ID_FROM_ASSOCIATION_IDENTIFIER - OUTSIDE_VALID_TERM_RANGE - OUTSIDE_VALID_TIME_RANGE - PORTAL_WIDE_CUSTOM_OBJECT_LIMIT_EXCEEDED - PROPERTY_DEFINITION_NOT_FOUND - PROPERTY_VALUE_NOT_FOUND - ROW_DATA_TOO_LARGE - SECONDARY_EMAIL_WRITE_FAILURE - UNKNOWN_ASSOCIATION_RECORD_ID - UNKNOWN_BAD_REQUEST - UNKNOWN_ERROR - UPDATE_ONLY_IMPORT extraContext: type: string description: >- Contexte supplémentaire lisible par l'utilisateur concernant l'erreur. id: type: string description: Un identifiant unique et stable pour cette erreur spécifique. invalidPropertyValue: $ref: '#/components/schemas/PropertyValue' invalidValue: type: string description: >- La valeur brute de la chaîne provenant du fichier d'import qui a causé l'échec de la validation. invalidValueToDisplay: type: string description: >- Un accesseur pratique qui renvoie soit la valeur de `invalidPropertyValue`, soit celle de `invalidValue`, selon celle qui est présente (en privilégiant la valeur de la propriété). knownColumnNumber: type: integer description: >- L'index de colonne à base zéro dans le fichier d'import où l'erreur s'est produite format: int32 objectType: type: string description: Le type d'objet CRM concerné par cette erreur. enum: - ABANDONED_CART - ACCEPTANCE_TEST - AD - AD_ACCOUNT - AD_CAMPAIGN - AD_GROUP - AI_FORECAST - ALL_PAGES - APPROVAL - APPROVAL_STEP - ATTRIBUTION - AUDIENCE - AUTOMATION_JOURNEY - AUTOMATION_PLATFORM_FLOW - AUTOMATION_PLATFORM_FLOW_ACTION - BET_ALERT - BET_DELIVERABLE_SERVICE - BLOG_LISTING_PAGE - BLOG_POST - CALL - CAMPAIGN - CAMPAIGN_BUDGET_ITEM - CAMPAIGN_SPEND_ITEM - CAMPAIGN_STEP - CAMPAIGN_TEMPLATE - CAMPAIGN_TEMPLATE_STEP - CART - CASE_STUDY - CHATFLOW - CLIP - CMS_URL - COMBO_EVENT_CONFIGURATION - COMMERCE_PAYMENT - COMMUNICATION - COMPANY - CONTACT - CONTACT_CREATE_ATTRIBUTION - CONTENT - CONTENT_AUDIT - CONTENT_AUDIT_PAGE - CONVERSATION - CONVERSATION_INBOX - CONVERSATION_SESSION - CRM_OBJECTS_DUMMY_TYPE - CRM_PIPELINES_DUMMY_TYPE - CTA - CTA_VARIANT - DATA_PRIVACY_CONSENT - DATA_SYNC_STATE - DEAL - DEAL_CREATE_ATTRIBUTION - DEAL_REGISTRATION - DEAL_SPLIT - DISCOUNT - DISCOUNT_CODE - DISCOUNT_TEMPLATE - EMAIL - ENGAGEMENT - EXPORT - EXTERNAL_WEB_URL - FEE - FEEDBACK_SUBMISSION - FEEDBACK_SURVEY - FILE_MANAGER_FILE - FILE_MANAGER_FOLDER - FOLDER - FORECAST - FORM - FORM_SUBMISSION_INBOUNDDB - GOAL_TARGET - GOAL_TARGET_GROUP - GOAL_TEMPLATE - GSC_PROPERTY - HUB - IMPORT - INVOICE - KEYWORD - KNOWLEDGE_ARTICLE - LANDING_PAGE - LEAD - LINE_ITEM - MARKETING_CALENDAR - MARKETING_CAMPAIGN_UTM - MARKETING_EMAIL - MARKETING_EVENT - MARKETING_EVENT_ATTENDANCE - MARKETING_SMS - MEDIA_BRIDGE - MEETING_EVENT - MIC - NOTE - OBJECT_LIST - ORDER - OWNER - PARTNER_ACCOUNT - PARTNER_CLIENT - PARTNER_CLIENT_REVENUE - PARTNER_SERVICE - PAYMENT_LINK - PAYMENT_SCHEDULE - PAYMENT_SCHEDULE_INSTALLMENT - PERMISSIONS_TESTING - PLAYBOOK - PLAYBOOK_QUESTION - PLAYBOOK_SUBMISSION - PLAYBOOK_SUBMISSION_ANSWER - PLAYLIST - PLAYLIST_FOLDER - PODCAST_EPISODE - PORTAL - PORTAL_OBJECT_SYNC_MESSAGE - POSTAL_MAIL - PRIVACY_SCANNER_COOKIE - PRODUCT - PRODUCT_OR_FOLDER - PROPERTY_INFO - PROSPECTING_AGENT_CONTACT_ASSIGNMENT - PUBLISHING_TASK - QUARANTINED_SUBMISSION - QUOTA - QUOTE - QUOTE_FIELD - QUOTE_MODULE - QUOTE_MODULE_FIELD - QUOTE_TEMPLATE - RESTORABLE_CRM_OBJECT - ROSTER - ROSTER_MEMBER - SALES_DOCUMENT - SALES_TASK - SALES_WORKLOAD - SALESFORCE_SYNC_ERROR - SCHEDULING_PAGE - SCHEMAS_BACKEND_TEST - SCORE_CONFIGURATION - SEQUENCE - SEQUENCE_ENROLLMENT - SEQUENCE_STEP - SEQUENCE_STEP_ENROLLMENT - SERVICE - SITE_PAGE - SNIPPET - SOCIAL_BROADCAST - SOCIAL_CHANNEL - SOCIAL_POST - SOCIAL_PROFILE - SOX_PROTECTED_DUMMY_TYPE - SOX_PROTECTED_TEST_TYPE - SUBMISSION_TAG - SUBSCRIPTION - TASK - TASK_TEMPLATE - TAX - TEMPLATE - TICKET - UNKNOWN - UNSUBSCRIBE - USER - VIEW - VIEW_BLOCK - WEB_INTERACTIVE objectTypeId: type: string description: L'identifiant moderne du type d'objet CRM concerné par cette erreur. sourceData: $ref: '#/components/schemas/ImportRowCore' Error: required: - category - correlationId - message type: object properties: category: type: string description: La catégorie d'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la demande. Incluez cette valeur dans tous les rapports d'erreurs ou tickets d'assistance format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: informations supplémentaires à propos de l'erreur items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associés contenant de la documentation sur l'erreur ou les mesures correctives recommandées message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur description: >- Représente une réponse d'erreur renvoyée par l'API lorsqu'une opération échoue. Ce composant est utilisé dans divers points de terminaison pour fournir des informations détaillées sur l'erreur rencontrée. example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base NextPage: required: - after type: object properties: after: type: string description: >- Un jeton de chaîne utilisé comme curseur pour récupérer l'ensemble de résultats suivant dans une réponse paginée. link: type: string description: >- Une chaîne d'URL qui fournit le lien vers la page de résultats suivante. description: >- Specifies the paging information needed to retrieve the next set of results in a paginated API response PropertyValue: required: - dataSensitivity - isEncrypted - isLargeValue - maskedSubstrings - name - persistenceTimestamp - requestId - selectedByUser - selectedByUserTimestamp - source - sourceId - sourceLabel - sourceMetadata - sourceUpstreamDeployable - sourceVid - timestamp - unit - updatedByUserId - useTimestampAsPersistenceTimestamp - value type: object properties: dataSensitivity: type: string description: "Une chaîne indiquant le niveau de sensibilité des données. Les valeurs valides sont «\_none\_», «\_standard\_» et «\_high\_»." enum: - high - none - standard isEncrypted: type: boolean description: Un booléen indiquant si la valeur de la propriété est chiffrée. isLargeValue: type: boolean description: Indique si la valeur dépasse les limites de taille normales. maskedSubstrings: $ref: '#/components/schemas/MaskedSubstrings' name: type: string description: >- Le nom de la propriété, représenté sous forme de chaîne de caractères. persistenceTimestamp: type: integer description: >- Lorsque la valeur a été enregistrée dans la base de données, en millisecondes epoch. format: int64 requestId: type: string description: >- Un identifiant de chaîne pour la requête associée à la valeur de la propriété. selectedByUser: type: boolean description: >- Un booléen indiquant si la valeur de la propriété a été sélectionnée par un utilisateur. selectedByUserTimestamp: type: integer description: >- Un horodatage Unix en millisecondes indiquant le moment où l'utilisateur a sélectionné la valeur de la propriété. format: int64 source: type: string description: "Une chaîne indiquant l'origine de la valeur de la propriété. Les valeurs valides incluent diverses sources telles que «\_API\_», «\_FORMULAIRE\_», «\_SALESFORCE\_», et d'autres." enum: - ACADEMY - ACCEPTANCE_TEST - ACTIVITY_AUTO_ASSOCIATE - ACTIVITY_LOG_REVERT - ADS - AI_GROUP - ANALYTICS - API - APPROVALS - ASSISTS - ASSOCIATIONS - AUTO_ASSOCIATE_BY_DOMAIN - AUTOMATION_JOURNEY - AUTOMATION_PLATFORM - AVATARS_SERVICE - BATCH_UPDATE - BCC_TO_CRM - BEHAVIORAL_EVENTS - BET_ASSIGNMENT - BET_CRM_CONNECTOR - BIDEN - BILLING - BOT - BREEZE_AGENT - CALCULATED - CENTRAL_EXCHANGE_RATES - CHATSPOT - CLONE_OBJECTS - COMMUNICATOR - COMPANIES - COMPANY_FAMILIES - COMPANY_INSIGHTS - CONNECTED_ACCOUNT - CONTACTS - CONTACTS_WEB - CONTENT_MEMBERSHIP - CONVERSATIONAL_ENRICHMENT - CONVERSATIONS - CRM_PROCESSES_PLATFORM - CRM_UI - CRM_UI_BULK_ACTION - CUSTOMER_AGENT - CUSTOMER_PORTAL - DATA_ENRICHMENT - DATA_QUALITY - DATASET - DEALS - DEFAULT - DELETE_OBJECTS - DI_WRITE_TO_CRM - EMAIL - EMAIL_INBOX_IMPORT - EMAIL_INTEGRATION - ENGAGEMENTS - EXTENSION - FILE_MANAGER - FLYWHEEL_PRODUCT_DATA_SYNC - FORECASTING - FORM - FORWARD_TO_CRM - GMAIL_INTEGRATION - GOALS - HEISENBERG - HELP_DESK - HELP_DESK_AI - IMPORT - INTEGRATION - INTEGRATIONS_PLATFORM - INTEGRATIONS_SYNC - INTENT - INTERNAL_PROCESSING - LEADIN - LEGAL_BASIS_REMEDIATION - MARKET_SOURCING - MARKETPLACE - MARKETS - MEETINGS - MERGE_COMPANIES - MERGE_CONTACTS - MERGE_OBJECTS - MERGE_REVERT_OBJECTS - MICROAPPS - MIGRATION - MOBILE_ANDROID - MOBILE_IOS - PAYMENTS - PIPELINE_SETTINGS - PLAYBOOKS - PORTAL_OBJECT_SYNC - PORTAL_USER_ASSOCIATOR - PRESENTATIONS - PRIMARY_AUTOMATION - PROPERTY_DEFAULT_VALUE - PROPERTY_RESTORE - PROPERTY_SETTINGS - PROSPECTING_AGENT - QUOTAS - QUOTES - RECYCLING_BIN - RESTORE_OBJECTS - REVENUE_PLATFORM - SALES - SALES_MESSAGES - SALESFORCE - SEQUENCES - SETTINGS - SIDEKICK - SIGNALS - SLACK_INTEGRATION - SMART_DATA_CAPTURE - SOCIAL - SUCCESS - TALLY - TASK - UNKNOWN - WAL_INCREMENTAL - WORK_UI - WORKFLOW_CONTACT_DELETE_ACTION - WORKFLOWS sourceId: type: string description: >- Un identifiant de chaîne pour la source de la valeur de la propriété. sourceLabel: type: string description: >- Une étiquette de chaîne décrivant la source de la valeur de la propriété. sourceMetadata: type: string description: >- Chaîne contenant des métadonnées sur la source de la valeur de la propriété. sourceUpstreamDeployable: type: string description: >- Une chaîne indiquant la source déployable en amont de la valeur de la propriété. sourceVid: type: array description: >- Un tableau d'entiers représentant les identifiants des vidéos sources associées à la valeur de la propriété. items: type: integer format: int64 timestamp: type: integer description: >- Un horodatage Unix en millisecondes indiquant le moment où la valeur de la propriété a été enregistrée. format: int64 unit: type: string description: >- Chaîne représentant l'unité de la valeur de la propriété, le cas échéant. updatedByUserId: type: integer description: >- Un nombre entier représentant l'ID de l'utilisateur ayant mis à jour la valeur de la propriété en dernier. format: int32 useTimestampAsPersistenceTimestamp: type: boolean description: >- Indicateur permettant de déterminer si le champ d'horodatage doit être utilisé comme horodatage de persistance. value: type: string description: >- La valeur réelle de la propriété, représentée sous forme de chaîne de caractères. description: >- Represents a single custom property of a marketing event, storing its name, value, metadata (like source, timestamp, and sensitivity), and related audit information for tracking changes. ImportRowCore: required: - additionalRowData - containsEncryptedProperties - fileId - lineNumber - rowData type: object properties: additionalRowData: type: array description: >- Un tableau de chaînes de caractères contenant toute donnée supplémentaire associée à cette ligne. items: type: string containsEncryptedProperties: type: boolean description: Indique si cette ligne contient des valeurs qui ont été cryptées. fileId: type: integer description: L'identifiant unique du fichier téléchargé contenant cette ligne. format: int64 lineNumber: type: integer description: "Le numéro de ligne indexé\_1 de cette ligne dans le fichier source. Le numéro de ligne\_0 est réservé aux erreurs à l'échelle du fichier qui ne correspondent pas à une ligne spécifique." format: int32 pageName: type: string description: Le nom de la feuille/page de calcul contenant cette ligne. rowData: type: array description: >- Un tableau de chaînes de caractères représentant les données principales de la ligne. items: type: string ErrorDetail: required: - message type: object properties: code: type: string description: Le code du statut associé au détail de l'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: '{missingScopes=[scope1, scope2]}' in: type: string description: Le nom du champ ou du paramètre dans lequel l'erreur a été trouvée. message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur description: >- Représente des informations détaillées sur une erreur survenue dans l'API. Ce composant est utilisé pour fournir un contexte et des spécificités supplémentaires sur les erreurs, généralement dans le cadre d'une réponse d'erreur. MaskedSubstrings: required: - substrings type: object properties: substrings: type: array description: >- Un tableau d'objets MaskedSubstring, chacun définissant une portion spécifique d'une chaîne à masquer. Cette propriété est requise et garantit que les données sensibles sont masquées de manière appropriée. items: $ref: '#/components/schemas/MaskedSubstring' MaskedSubstring: required: - end - label - start type: object properties: end: type: integer description: Un entier indiquant la position de fin de la sous-chaîne. format: int32 label: type: string start: type: integer description: Un entier indiquant la position de début de la sous-chaîne. format: int32 responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: crm.import: '' ````