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>"
}
}
}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.
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>"
}
}
}Produtos suportados
Escopos Necessários
The access token received from the authorization server in the OAuth 2.0 flow.
O ID exclusivo da importação.
O token do cursor de paginação do último recurso lido com sucesso será retornado como a propriedade JSON "paging.next.after" de uma resposta paginada que contém mais resultados.
Defina como Verdadeiro para receber uma mensagem explicando o erro.
Defina como Verdadeiro para receber os valores de dados da linha com erro.
O número máximo de resultados a serem exibidos por página.
successful operation
Mostrar atributos filhos
A data e hora em milissegundos da época do registro do erro.
A classificação dos problemas ocorridos durante o processamento da importação.
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 Um identificador exclusivo e estável para esse erro específico.
Mostrar atributos filhos
Indica se esta linha contém valores criptografados.
O identificador exclusivo do arquivo carregado que contém esta linha.
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.
O nome da planilha/página que contém esta linha.
Uma mensagem de erro em linguagem acessível a humanos.
Contexto adicional em linguagem acessível a humanos sobre o erro.
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 filhos
The sensitivity level of the property, such as "non_sensitive", "sensitive", and "highly_sensitive".
high, none, standard Whether the property value is encrypted.
Indica se o valor excede os limites de tamanho normais.
The unique property name.
Quando o valor foi persistido no banco de dados, em milissegundos de época.
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.
Sinalizador que define se o campo de data/hora deve ser usado como data/hora de persistência.
The property value.
O valor bruto da string do arquivo de importação que causou a falha na validação.
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).
O índice da coluna com base zero no arquivo de importação onde ocorreu o erro.
O tipo de objeto do CRM afetado por este erro.
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 O identificador de tipo de objeto moderno para o objeto do CRM afetado por este erro.
Mostrar atributos filhos