> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve errors for a specific import > Obtiene los registros de errores detallados de una operación de importación específica, lo que te permite identificar y solucionar los registros que fallaron durante el procesamiento. export const ScopesList = ({scopes = [], description = "Esta API requiere uno de los siguientes ámbitos:"}) => { if (!scopes || scopes.length === 0) { return null; } const sortedScopes = scopes.sort((a, b) => a.localeCompare(b)); return
{description}
{sortedScopes.map((scope, index) =>
{scope}
)}
; }; export const SupportedProducts = ({marketing, sales, service, cms, marketingLevel, salesLevel, serviceLevel, cmsLevel}) => { const translations = { header: "Productos compatibles", description: "Se requiere uno de los siguientes productos o productos de ediciones superiores.", productNames: { marketing: "Marketing Hub", sales: "Sales Hub", service: "Service Hub", cms: "Content Hub" }, tiers: { free: "Gratuito", starter: "Starter", professional: "Pro", enterprise: "Enterprise" } }; const translateTier = tier => { if (!tier) return ''; const lowerTier = tier.toLowerCase(); return translations.tiers[lowerTier] || tier; }; const products = [{ name: marketing ? translations.productNames.marketing : '', level: translateTier(marketingLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/marketing-bolt.svg", alt: "Marketing Hub" }, { name: sales ? translations.productNames.sales : '', level: translateTier(salesLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/sales-star.svg", alt: "Sales Hub" }, { name: service ? translations.productNames.service : '', level: translateTier(serviceLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/service-heart.svg", alt: "Service Hub" }, { name: cms ? translations.productNames.cms : '', level: translateTier(cmsLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/content-play.svg", alt: "Content Hub" }].filter(product => product.name && product.level); if (products.length === 0) return null; return
{translations.description}
{products.map((product, index) =>
{product.alt} {product.name} - {product.level}
)}
; }; ## 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: Obtener errores de una importación específica description: >- Obtiene los registros de errores detallados de una operación de importación específica, lo que te permite identificar y solucionar los registros que fallaron durante el procesamiento. operationId: >- get-/crm/imports/2026-03/{importId}/errors_/crm/imports/v3/{importId}/errors parameters: - name: importId in: path description: '' required: true style: simple explode: false schema: type: integer format: int64 - name: after in: query description: >- El token del cursor de paginación del último recurso leído con éxito se devolverá como la propiedad JSON `paging.next.after` de una respuesta paginada que contenga más resultados. required: false style: form explode: true schema: type: string - name: includeErrorMessage in: query description: '' required: false style: form explode: true schema: type: boolean - name: includeRowData in: query description: '' required: false style: form explode: true schema: type: boolean - name: limit in: query description: El número máximo de resultados que se mostrarán 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 items: $ref: '#/components/schemas/PublicImportError' ForwardPaging: type: object properties: next: $ref: '#/components/schemas/NextPage' description: >- Información de paginación para la paginación de solo avance. Contiene la referencia a la página siguiente cuando hay más resultados disponibles; se omite o está vacía en la última página. PublicImportError: required: - createdAt - errorType - id - sourceData type: object properties: createdAt: type: integer description: >- La marca de tiempo en milisegundos Epoch en que se registró este error. format: int64 errorMessage: type: string description: Un mensaje de error legible por humanos. errorType: type: string description: >- La clasificación de lo que salió mal durante el proceso de importación. 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 legible por humanos sobre el error. id: type: string description: Un identificador único y estable para este error específico. invalidPropertyValue: $ref: '#/components/schemas/PropertyValue' invalidValue: type: string description: >- El valor de cadena sin procesar del archivo de importación que causó el fallo de validación. invalidValueToDisplay: type: string description: >- Un práctico accesorio que devuelve el valor de `invalidPropertyValue` o `invalidValue`, el que esté presente (es preferible el valor de la propiedad). knownColumnNumber: type: integer description: >- El índice de columna de base cero en el archivo de importación en el que se produjo el error format: int32 objectType: type: string description: El tipo de objeto del CRM afectado por este error. 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: >- El identificador del tipo de objeto moderno para el objeto del CRM afectado por este error. sourceData: $ref: '#/components/schemas/ImportRowCore' Error: required: - category - correlationId - message type: object properties: category: type: string description: La categoría del error context: type: object additionalProperties: type: array items: type: string description: Contexto de la condición de error example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identificador único para la solicitud. Incluye este valor con cualquier informe de error o ticket de asistencia. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: información adicional acerca del error items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Un mapa de nombres de enlaces a las URI asociadas que contienen documentación sobre el error o los pasos recomendados para solucionarlo message: type: string description: >- Un mensaje legible en el que se describa el error y los pasos para solucionarlo, si procede example: An error occurred subCategory: type: string description: >- Una categoría específica que contiene detalles más concretos acerca del error description: >- Representa una respuesta de error que devuelve la API cuando una operación falla. Este componente se usa en varios puntos de terminación para dar información detallada sobre el error que se encontró. 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: A paging cursor token for retrieving subsequent pages. link: type: string description: A URL that can be used to retrieve the next page results. 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: >- The sensitivity level of the property, such as "non_sensitive", "sensitive", and "highly_sensitive". enum: - high - none - standard isEncrypted: type: boolean description: Whether the property value is encrypted. isLargeValue: type: boolean description: Indica si el valor supera los límites normales de tamaño. maskedSubstrings: $ref: '#/components/schemas/MaskedSubstrings' name: type: string description: The unique property name. persistenceTimestamp: type: integer description: >- Cuándo se almacenó el valor en la base de datos, en milisegundos Epoch. format: int64 requestId: type: string description: A unique ID associated with this request. selectedByUser: type: boolean description: Whether the value was selected by a user. selectedByUserTimestamp: type: integer description: The timestamp when the value was selected by a user, if applicable. format: int64 source: type: string description: The origin of the property value, such as "IMPORT" or "API". 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: The ID of the property source indicating where it was created. sourceLabel: type: string description: A human-readable label. sourceMetadata: type: string description: Metadata providing additional context about the source. sourceUpstreamDeployable: type: string sourceVid: type: array description: The unique identifier associated with the source. items: type: integer format: int64 timestamp: type: integer description: When the value was set, as a 64-bit integer. format: int64 unit: type: string description: The unit of measurement or context for the value. updatedByUserId: type: integer description: The ID of the user who updated the property. format: int32 useTimestampAsPersistenceTimestamp: type: boolean description: >- Señal que indica si se debe utilizar el campo de marca de tiempo como marca de tiempo de persistencia. value: type: string description: The property value. 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 items: type: string containsEncryptedProperties: type: boolean description: Indica si esta fila contiene valores encriptados. fileId: type: integer description: El identificador único del archivo subido que contiene esta fila. format: int64 lineNumber: type: integer description: >- El número de línea con índice 1 de esta fila en el archivo de origen. El número de línea 0 se reserva para los errores de todo el archivo que no corresponden a una fila específica. format: int32 pageName: type: string description: El nombre de la hoja de cálculo o página que contiene esta fila. rowData: type: array items: type: string ErrorDetail: required: - message type: object properties: code: type: string description: El código de estado asociado al detalle del error context: type: object additionalProperties: type: array items: type: string description: Contexto de la condición de error example: '{missingScopes=[scope1, scope2]}' in: type: string description: El nombre del campo o parámetro en el que se encontró el error. message: type: string description: >- Un mensaje legible en el que se describa el error y los pasos para solucionarlo, si procede subCategory: type: string description: >- Una categoría específica que contiene detalles más concretos acerca del error description: >- Representa información detallada sobre un error que ocurrió en la API. Este componente se usa para dar contexto adicional y detalles específicos sobre los errores, normalmente como parte de una respuesta de error. MaskedSubstrings: required: - substrings type: object properties: substrings: type: array items: $ref: '#/components/schemas/MaskedSubstring' MaskedSubstring: required: - end - start type: object properties: end: type: integer format: int32 start: type: integer 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: '' ````