curl --request GET \
--url https://api.hubapi.com/crm/v3/imports/{importId}/errors \
--header 'Authorization: Bearer <token>'{
"results": [
{
"createdAt": 123,
"errorType": "AMBIGUOUS_ENUMERATION_OPTION",
"id": "<string>",
"sourceData": {
"containsEncryptedProperties": true,
"fileId": 123,
"lineNumber": 123,
"rowData": [
"<string>"
],
"pageName": "<string>"
},
"errorMessage": "<string>",
"extraContext": "<string>",
"invalidPropertyValue": {
"dataSensitivity": "high",
"isEncrypted": true,
"isLargeValue": true,
"name": "<string>",
"persistenceTimestamp": 123,
"requestId": "<string>",
"selectedByUser": true,
"selectedByUserTimestamp": 123,
"source": "ACADEMY",
"sourceId": "<string>",
"sourceLabel": "<string>",
"sourceMetadata": "<string>",
"sourceVid": [
123
],
"timestamp": 123,
"unit": "<string>",
"updatedByUserId": 123,
"useTimestampAsPersistenceTimestamp": true,
"value": "<string>"
},
"invalidValue": "<string>",
"invalidValueToDisplay": "<string>",
"knownColumnNumber": 123,
"objectType": "ABANDONED_CART",
"objectTypeId": "<string>"
}
],
"paging": {
"next": {
"after": "<string>",
"link": "<string>"
}
}
}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.
curl --request GET \
--url https://api.hubapi.com/crm/v3/imports/{importId}/errors \
--header 'Authorization: Bearer <token>'{
"results": [
{
"createdAt": 123,
"errorType": "AMBIGUOUS_ENUMERATION_OPTION",
"id": "<string>",
"sourceData": {
"containsEncryptedProperties": true,
"fileId": 123,
"lineNumber": 123,
"rowData": [
"<string>"
],
"pageName": "<string>"
},
"errorMessage": "<string>",
"extraContext": "<string>",
"invalidPropertyValue": {
"dataSensitivity": "high",
"isEncrypted": true,
"isLargeValue": true,
"name": "<string>",
"persistenceTimestamp": 123,
"requestId": "<string>",
"selectedByUser": true,
"selectedByUserTimestamp": 123,
"source": "ACADEMY",
"sourceId": "<string>",
"sourceLabel": "<string>",
"sourceMetadata": "<string>",
"sourceVid": [
123
],
"timestamp": 123,
"unit": "<string>",
"updatedByUserId": 123,
"useTimestampAsPersistenceTimestamp": true,
"value": "<string>"
},
"invalidValue": "<string>",
"invalidValueToDisplay": "<string>",
"knownColumnNumber": 123,
"objectType": "ABANDONED_CART",
"objectTypeId": "<string>"
}
],
"paging": {
"next": {
"after": "<string>",
"link": "<string>"
}
}
}Productos compatibles
Ámbitos Requeridos
The access token received from the authorization server in the OAuth 2.0 flow.
El ID único de la importación.
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.
Establecer en True (Verdadero) para recibir un mensaje que explica el error.
Establecer en True (Verdadero) para recibir los valores de los datos de la fila que contiene el error.
El número máximo de resultados que se mostrarán por página.
successful operation
Mostrar atributos secundarios
La marca de tiempo en milisegundos Epoch en que se registró este error.
La clasificación de lo que salió mal durante el proceso de importación.
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_PROPERTY_VALUE, FAILED_TO_CREATE_ASSOCIATION, 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_ENUMERATION_OPTION, INVALID_EVENT, INVALID_EVENT_TIMESTAMP, INVALID_FILE_TYPE, INVALID_NUMBER_SIZE, INVALID_OBJECT_ID, INVALID_RECORD_ID, INVALID_REQUIRED_PROPERTY, INVALID_SHEET_COUNT, INVALID_SPREADSHEET, LIMIT_EXCEEDED, 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 Un identificador único y estable para este error específico.
Mostrar atributos secundarios
Indica si esta fila contiene valores encriptados.
El identificador único del archivo subido que contiene esta fila.
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.
El nombre de la hoja de cálculo o página que contiene esta fila.
Un mensaje de error legible por humanos.
Contexto adicional legible por humanos sobre el error.
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.
Mostrar atributos secundarios
The sensitivity level of the property, such as "non_sensitive", "sensitive", and "highly_sensitive".
high, none, standard Whether the property value is encrypted.
Indica si el valor supera los límites normales de tamaño.
The unique property name.
Cuándo se almacenó el valor en la base de datos, en milisegundos Epoch.
A unique ID associated with this request.
Whether the value was selected by a user.
The timestamp when the value was selected by a user, if applicable.
The origin of the property value, such as "IMPORT" or "API".
ACADEMY, ACCEPTANCE_TEST, ADS, AI_GROUP, ANALYTICS, API, APPROVALS, ASSISTS, ASSOCIATIONS, AUTOMATION_JOURNEY, AUTOMATION_PLATFORM, AVATARS_SERVICE, BATCH_UPDATE, BCC_TO_CRM, BEHAVIORAL_EVENTS, BET_ASSIGNMENT, BET_CRM_CONNECTOR, BIDEN, BILLING, BOT, CALCULATED, CHATSPOT, COMMUNICATOR, COMPANIES, COMPANY_FAMILIES, COMPANY_INSIGHTS, CONTACTS, CONTACTS_WEB, CONTENT_MEMBERSHIP, CONVERSATIONS, CRM_UI, CRM_UI_BULK_ACTION, DATA_ENRICHMENT, DEALS, DEFAULT, EMAIL, EMAIL_INTEGRATION, ENGAGEMENTS, EXTENSION, FILE_MANAGER, FLYWHEEL_PRODUCT_DATA_SYNC, FORECASTING, FORM, FORWARD_TO_CRM, GMAIL_INTEGRATION, GOALS, HEISENBERG, HELP_DESK, IMPORT, INTEGRATION, INTEGRATIONS_PLATFORM, INTEGRATIONS_SYNC, INTENT, INTERNAL_PROCESSING, LEADIN, MARKETPLACE, MEETINGS, MERGE_COMPANIES, MERGE_CONTACTS, MERGE_OBJECTS, MICROAPPS, MIGRATION, MOBILE_ANDROID, MOBILE_IOS, PAYMENTS, PIPELINE_SETTINGS, PLAYBOOKS, PORTAL_OBJECT_SYNC, PORTAL_USER_ASSOCIATOR, PRESENTATIONS, PROPERTY_SETTINGS, PROSPECTING_AGENT, QUOTAS, QUOTES, RECYCLING_BIN, SALES, SALES_MESSAGES, SALESFORCE, SEQUENCES, SETTINGS, SIDEKICK, SIGNALS, SLACK_INTEGRATION, SOCIAL, SUCCESS, TALLY, TASK, UNKNOWN, WAL_INCREMENTAL, WORKFLOW_CONTACT_DELETE_ACTION, WORKFLOWS The ID of the property source indicating where it was created.
A human-readable label.
Metadata providing additional context about the source.
The unique identifier associated with the source.
When the value was set, as a 64-bit integer.
The unit of measurement or context for the value.
The ID of the user who updated the property.
Señal que indica si se debe utilizar el campo de marca de tiempo como marca de tiempo de persistencia.
The property value.
El valor de cadena sin procesar del archivo de importación que causó el fallo de validación.
Un práctico accesorio que devuelve el valor de invalidPropertyValue o invalidValue, el que esté presente (es preferible el valor de la propiedad).
El índice de columna de base cero en el archivo de importación en el que se produjo el error
El tipo de objeto del CRM afectado por este error.
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 El identificador del tipo de objeto moderno para el objeto del CRM afectado por este error.
Mostrar atributos secundarios