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>"
}
}
}Récupère les fiches d’informations d’erreurs détaillées pour une opération d’import spécifique, ce qui vous permet d’identifier et de corriger les problèmes liés aux fiches d’informations qui ont échoué pendant le traitement.
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>"
}
}
}Produits pris en charge
Portées requises
The access token received from the authorization server in the OAuth 2.0 flow.
L'ID unique de l'import.
Le jeton de curseur de pagination de la dernière ressource lue avec succès sera renvoyé en tant que propriété JSON « paging.next.after » d'une réponse paginée contenant plus de résultats.
Définir sur la valeur True pour recevoir un message expliquant l'erreur.
Définir sur la valeur True pour recevoir les valeurs de données pour la ligne erronée.
Le nombre maximum de résultats à afficher par page.
successful operation
Afficher attributs enfants
L'horodatage en millisecondes epoch à laquelle cette erreur a été enregistrée.
La classification des problèmes rencontrés lors du traitement des imports.
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 identifiant unique et stable pour cette erreur spécifique.
Afficher attributs enfants
Indique si cette ligne contient des valeurs qui ont été cryptées.
L'identifiant unique du fichier téléchargé contenant cette ligne.
Le numéro de ligne indexé 1 de cette ligne dans le fichier source. Le numéro de ligne 0 est réservé aux erreurs à l'échelle du fichier qui ne correspondent pas à une ligne spécifique.
Le nom de la feuille/page de calcul contenant cette ligne.
Un message d'erreur lisible par l'utilisateur.
Contexte supplémentaire lisible par l'utilisateur concernant l'erreur.
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.
Afficher attributs enfants
The sensitivity level of the property, such as "non_sensitive", "sensitive", and "highly_sensitive".
high, none, standard Whether the property value is encrypted.
Indique si la valeur dépasse les limites de taille normales.
The unique property name.
Lorsque la valeur a été enregistrée dans la base de données, en millisecondes 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.
Indicateur permettant de déterminer si le champ d'horodatage doit être utilisé comme horodatage de persistance.
The property value.
La valeur brute de la chaîne provenant du fichier d'import qui a causé l'échec de la validation.
Un accesseur pratique qui renvoie soit la valeur de invalidPropertyValue, soit celle de invalidValue, selon celle qui est présente (en privilégiant la valeur de la propriété).
L'index de colonne à base zéro dans le fichier d'import où l'erreur s'est produite
Le type d'objet CRM concerné par cette erreur.
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 L'identifiant moderne du type d'objet CRM concerné par cette erreur.
Afficher attributs enfants