--- title: "Retrieve errors for a specific import" method: GET path: "/crm/imports/2026-09/{importId}/errors" tags: ["Basic"] --- # Retrieve errors for a specific import `GET /crm/imports/2026-09/{importId}/errors` ## Request - Base URL: `https://api.hubapi.com` - URL: `https://api.hubapi.com/crm/imports/2026-09/{importId}/errors` - Auth: OAuth 2 - Authorization code: `https://app.hubspot.com/oauth/authorize` - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.import` Retrieves detailed error records for a specific import operation, enabling you to identify and troubleshoot records that failed during processing. ## Path parameters - `importId` integer, required ## Query parameters - `after` string - `includeErrorMessage` boolean - `includeRowData` boolean - `limit` integer ## Response `200` successful operation - CollectionResponsePublicImportErrorForwardPaging - `paging` ForwardPaging: Paging information for forward-only pagination. Contains the next page reference when more results are available; omitted or empty on the last page. - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response - `after` string, required: A string token used as a cursor to fetch the next set of results in a paginated response. - `link` string: A URL string that provides the link to the next page of results. - `results` PublicImportError[], required: An array of public import errors, each represented by a PublicImportError object. - `createdAt` integer, required: The epoch millisecond timestamp when this error was recorded. - `errorMessage` string: A human-readable error message. - `errorType` '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', required: The classification of what went wrong during import processing. - `extraContext` string: Additional human-readable context about the error. - `id` string, required: A unique, stable identifier for this specific error. - `invalidPropertyValue` PropertyValue: 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. - `dataSensitivity` 'high' | 'none' | 'standard', required: A string indicating the sensitivity level of the data. Valid values are 'none', 'standard', and 'high'. - `isEncrypted` boolean, required: A boolean indicating whether the property value is encrypted. - `isLargeValue` boolean, required: Indicates if the value exceeds normal size limits. - `maskedSubstrings` MaskedSubstrings, required - `substrings` MaskedSubstring[], required: An array of MaskedSubstring objects, each defining a specific portion of a string to be masked. This property is required and ensures that sensitive data is appropriately obscured. - `end` integer, required: An integer indicating the ending position of the substring. - `label` string, required - `start` integer, required: An integer indicating the starting position of the substring. - `name` string, required: The name of the property, represented as a string. - `persistenceTimestamp` integer, required: When the value was persisted to database, in epoch milliseconds. - `requestId` string, required: A string identifier for the request associated with the property value. - `selectedByUser` boolean, required: A boolean indicating whether the property value was selected by a user. - `selectedByUserTimestamp` integer, required: A Unix timestamp in milliseconds indicating when the user selected the property value. - `source` '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', required: A string indicating the origin of the property value. Valid values include various sources such as 'API', 'FORM', 'SALESFORCE', and others. - `sourceId` string, required: A string identifier for the source of the property value. - `sourceLabel` string, required: A string label describing the source of the property value. - `sourceMetadata` string, required: A string containing metadata about the source of the property value. - `sourceUpstreamDeployable` string, required: A string indicating the upstream deployable source of the property value. - `sourceVid` integer[], required: An array of integers representing the source video IDs associated with the property value. - `timestamp` integer, required: A Unix timestamp in milliseconds indicating when the property value was recorded. - `unit` string, required: A string representing the unit of the property value, if applicable. - `updatedByUserId` integer, required: An integer representing the ID of the user who last updated the property value. - `useTimestampAsPersistenceTimestamp` boolean, required: Flag indicating whether to use the timestamp field as the persistence timestamp. - `value` string, required: The actual value of the property, represented as a string. - `invalidValue` string: The raw string value from the import file that caused the validation failure. - `invalidValueToDisplay` string: A convenience accessor that returns either the value from `invalidPropertyValue` or `invalidValue`, whichever is present (preferring the property value). - `knownColumnNumber` integer: The zero-based column index in the import file where the error occurred - `objectType` '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': The CRM object type affected by this error. - `objectTypeId` string: The modern object type identifier for the CRM object affected by this error. - `sourceData` ImportRowCore, required - `additionalRowData` string[], required: An array of strings containing any additional data associated with this row. - `containsEncryptedProperties` boolean, required: Indicates whether this row contains values that were encrypted. - `fileId` integer, required: The unique identifier of the uploaded file containing this row. - `lineNumber` integer, required: The 1-indexed line number of this row in the source file. Line number 0 is reserved for file-wide errors that don't correspond to a specific row. - `pageName` string: The name of the spreadsheet sheet/page containing this row. - `rowData` string[], required: An array of strings representing the core data of the row. ## Other responses - `default`: An error occurred. ## Changes - **2026-10-15** (2026-09) `447517f327fb`: 1 info - added the required property `results/items/invalidPropertyValue/maskedSubstrings/substrings/items/label` to the response with the `200` status - **2026-09-03** (2026-09) `8c1d8b465db8`: 2 breaking, 8 warning, 3 info - the `results/items/createdAt` response's property format changed from `int32` to `int64` for status `200` - the `results/items/sourceData/fileId` response's property format changed from `int32` to `int64` for status `200` - added the new `BREEZE_AGENT` enum value to the `results/items/invalidPropertyValue/source` response property for the response status `200` - added the new `CONNECTED_ACCOUNT` enum value to the `results/items/invalidPropertyValue/source` response property for the response status `200` - …9 more [Operation history](https://skmtc.dev/hubspot/apis/crm-imports/changes/crm/imports/2026-09/:importId/errors/get.md) --- [API](https://skmtc.dev/hubspot/apis/crm-imports.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-imports/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-imports/revisions/447517f327fb?raw)