> ## Documentation Index > Fetch the complete documentation index at: https://br.developers.hubspot.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve errors for a specific import > Recupera registros detalhados de erros para uma operação de importação específica, permitindo identificar e solucionar problemas em registros que falharam durante o processamento. > **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: Recuperar erros para uma importação específica description: >- Recupera registros detalhados de erros para uma operação de importação específica, permitindo identificar e solucionar problemas em registros que falharam durante o processamento. operationId: >- get-/crm/imports/2026-03/{importId}/errors_/crm/imports/v3/{importId}/errors parameters: - name: importId in: path description: >- Identificador exclusivo da importação cujos erros devem ser recuperados. required: true style: simple explode: false schema: type: integer format: int64 - name: after in: query description: >- O token do cursor de paginação do último recurso lido será retornado como a propriedade JSON `paging.next.after` de uma resposta paginada que contém mais resultados. required: false style: form explode: true schema: type: string - name: includeErrorMessage in: query description: >- Booleano que indica se mensagens de erro detalhadas devem ser incluídas na resposta. required: false style: form explode: true schema: type: boolean - name: includeRowData in: query description: >- Booleano que indica se dados da linha associados a cada erro devem ser incluídos na resposta. required: false style: form explode: true schema: type: boolean - name: limit in: query description: O número máximo de resultados a serem exibidos por página. 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: >- Matriz de erros de importação públicos, cada um deles representado pelo objeto PublicImportError. items: $ref: '#/components/schemas/PublicImportError' ForwardPaging: type: object properties: next: $ref: '#/components/schemas/NextPage' description: >- Informações de paginação para paginação somente para frente. Contém a referência da próxima página quando há mais resultados disponíveis; é omitida ou fica vazia na última página. PublicImportError: required: - createdAt - errorType - id - sourceData type: object properties: createdAt: type: integer description: A data e hora em milissegundos da época do registro do erro. format: int64 errorMessage: type: string description: Uma mensagem de erro em linguagem acessível a humanos. errorType: type: string description: >- A classificação dos problemas ocorridos durante o processamento da importação. 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: Contexto adicional em linguagem acessível a humanos sobre o erro. id: type: string description: Um identificador exclusivo e estável para esse erro específico. invalidPropertyValue: $ref: '#/components/schemas/PropertyValue' invalidValue: type: string description: >- O valor bruto da string do arquivo de importação que causou a falha na validação. invalidValueToDisplay: type: string description: >- Um acessador de conveniência que retorna o valor de "invalidPropertyValue" ou de "invalidValue", o que estiver presente (dando preferência ao valor da propriedade). knownColumnNumber: type: integer description: >- O índice da coluna com base zero no arquivo de importação onde ocorreu o erro. format: int32 objectType: type: string description: O tipo de objeto do CRM afetado por este erro. 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: >- O identificador de tipo de objeto moderno para o objeto do CRM afetado por este erro. sourceData: $ref: '#/components/schemas/ImportRowCore' Error: required: - category - correlationId - message type: object properties: category: type: string description: A categoria de erro context: type: object additionalProperties: type: array items: type: string description: Contexto sobre a condição do erro example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Um identificador exclusivo para a solicitação. Inclua este valor em relatórios de erro ou tickets de suporte format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: mais informações sobre o erro items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Um mapa de nomes de links para URIs associados que contêm documentação sobre o erro ou as etapas de correção recomendadas message: type: string description: >- Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado example: An error occurred subCategory: type: string description: >- Uma categoria específica que contém mais detalhes específicos sobre o erro description: >- Representa uma resposta de erro retornada pela API quando uma operação falha. Este componente é usado em vários endpoints para fornecer informações detalhadas sobre o erro encontrado. 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: >- Um token de string usado como cursor para buscar o próximo conjunto de resultados em uma resposta paginada. link: type: string description: >- Uma string de URL que fornece o link para a próxima página de resultados. 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: >- String que indica nível de sensibilidade dos dados. Valores válidos são "none", "standard" e "high". enum: - high - none - standard isEncrypted: type: boolean description: Booleano que indica se o valor da propriedade está criptografado. isLargeValue: type: boolean description: Indica se o valor excede os limites de tamanho normais. maskedSubstrings: $ref: '#/components/schemas/MaskedSubstrings' name: type: string description: Nome da propriedade, representado como uma string. persistenceTimestamp: type: integer description: >- Quando o valor foi persistido no banco de dados, em milissegundos de época. format: int64 requestId: type: string description: >- Identificador de string para solicitação associada ao valor da propriedade. selectedByUser: type: boolean description: >- Booleano que indica se o valor da propriedade foi selecionado por um usuário. selectedByUserTimestamp: type: integer description: >- Data/hora Unix em milissegundos indicando quando o usuário selecionou o valor da propriedade. format: int64 source: type: string description: >- String que indica a origem do valor da propriedade. Valores válidos incluem várias fontes, como "API", "FORM", "SALESFORCE" e outras. 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: Um identificador de string para a origem do valor da propriedade. sourceLabel: type: string description: Rótulo de string que descreve a origem do valor da propriedade. sourceMetadata: type: string description: >- Uma string contendo metadados sobre a origem do valor da propriedade. sourceUpstreamDeployable: type: string description: >- String que indica a fonte de implantação upstream do valor da propriedade. sourceVid: type: array description: >- Matriz de números inteiros que representa IDs de vídeo de origem associados ao valor da propriedade. items: type: integer format: int64 timestamp: type: integer description: >- Data/hora Unix em milissegundos indicando quando o valor da propriedade foi registrado. format: int64 unit: type: string description: >- Uma string que representa a unidade do valor da propriedade, se aplicável. updatedByUserId: type: integer description: >- Número inteiro que representa ID do usuário que atualizou o valor da propriedade pela última vez. format: int32 useTimestampAsPersistenceTimestamp: type: boolean description: >- Sinalizador que define se o campo de data/hora deve ser usado como data/hora de persistência. value: type: string description: O valor real da propriedade, representado como uma string. 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: Matriz de strings contendo dados adicionais associados a esta linha. items: type: string containsEncryptedProperties: type: boolean description: Indica se esta linha contém valores criptografados. fileId: type: integer description: >- O identificador exclusivo do arquivo carregado que contém esta linha. format: int64 lineNumber: type: integer description: >- O número da linha correspondente a esta linha no arquivo de origem, com índice a partir de 1. A linha número 0 é reservada para erros que afetam todo o arquivo e não correspondem a uma linha específica. format: int32 pageName: type: string description: O nome da planilha/página que contém esta linha. rowData: type: array description: Matriz de strings que representa dados principais da linha. items: type: string ErrorDetail: required: - message type: object properties: code: type: string description: O código de status associado ao detalhe do erro context: type: object additionalProperties: type: array items: type: string description: Contexto sobre a condição do erro example: '{missingScopes=[scope1, scope2]}' in: type: string description: O nome do campo ou parâmetro no qual o erro foi encontrado. message: type: string description: >- Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado subCategory: type: string description: >- Uma categoria específica que contém mais detalhes específicos sobre o erro description: >- Representa informações detalhadas sobre um erro ocorrido na API. Este componente é usado para fornecer contexto e detalhes adicionais sobre os erros, geralmente como parte de uma resposta de erro. MaskedSubstrings: required: - substrings type: object properties: substrings: type: array description: >- Matriz de objetos MaskedSubstring, cada um definindo uma parte específica de uma string a ser mascarada. Esta propriedade é obrigatória e garante que dados confidenciais sejam ocultados de forma adequada. items: $ref: '#/components/schemas/MaskedSubstring' MaskedSubstring: required: - end - label - start type: object properties: end: type: integer description: Número inteiro que indica a posição final da substring. format: int32 label: type: string start: type: integer description: Número inteiro que indica a posição inicial da substring. 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: '' ````