Get /crm/v3/imports/{import Id}/errors /crm/v3/imports/{import Id}/errors

Retrieve errors for a specific import

GET/crm/v3/imports/{importId}/errors

Use it in a workflow

Add a step and choose the HubSpot connector.
Pick the Get /crm/v3/imports/{import Id}/errors /crm/v3/imports/{import Id}/errors action (under Imports).
Fill in the fields below, then reference the result from later steps as {{getCrmV3ImportsImportIdErrorsCrmV3ImportsImportIdErrors.response.data}}.

Request

Path parameters

importIdinteger (int64)required

Query parameters

afterstring

The paging cursor token of the last successfully read resource will be returned as the `paging.next.after` JSON property of a paged response containing more results.

includeErrorMessageboolean

includeRowDataboolean

limitinteger (int32)

The maximum number of results to display per page.

Response

Returns 200 with an object. Read it in later steps with {{getCrmV3ImportsImportIdErrorsCrmV3ImportsImportIdErrors.response.data.<field>}}.

pagingobject

nextobject2 fields

Specifies the paging information needed to retrieve the next set of results in a paginated API response

resultsarray<object>

createdAtinteger (int64)required

The epoch millisecond timestamp when this error was recorded.

errorMessagestring

A human-readable error message.

errorTypestringrequired

The classification of what went wrong during import processing.

One ofAMBIGUOUS_ENUMERATION_OPTIONASSOCIATION_LABEL_NOT_FOUNDASSOCIATION_LIMIT_EXCEEDEDASSOCIATION_RECORD_NOT_FOUNDCOLUMN_TOO_LARGECOULD_NOT_FIND_BUSINESS_UNITCOULD_NOT_FIND_OWNERCOULD_NOT_PARSE_DATECOULD_NOT_PARSE_NUMBERCOULD_NOT_PARSE_ROWCOULD_NOT_PARSE_TERMCREATE_ONLY_IMPORTDUPLICATE_ALTERNATE_IDDUPLICATE_ASSOCIATION_IDDUPLICATE_EVENTDUPLICATE_OBJECT_IDDUPLICATE_RECORD_IDDUPLICATE_ROW_CONTENTDUPLICATE_UNIQUE_CREATION_KEYDUPLICATE_UNIQUE_PROPERTY_VALUEFAILED_TO_CREATE_ASSOCIATIONFAILED_TO_FIND_RECORD_FOR_ASSOCIATIONSFAILED_TO_OPT_OUT_CONTACTFAILED_TO_PROCESS_OBJECT_WITH_EMPTY_PROPERTY_VALUESFAILED_VALIDATIONFILE_NOT_FOUNDGDPR_BLACKLISTED_EMAILINCORRECT_NUMBER_OF_COLUMNSINVALID_ALTERNATE_IDINVALID_ASSOCIATION_IDENTIFIERINVALID_ASSOCIATION_KEYINVALID_COLUMN_CONFIGURATIONINVALID_CUSTOM_PROPERTY_VALIDATIONINVALID_DOMAININVALID_EMAILINVALID_ENUM_FILE_ID_OR_URLINVALID_ENUMERATION_OPTIONINVALID_EVENTINVALID_EVENT_TIMESTAMPINVALID_FILE_TYPE

extraContextstring

Additional human-readable context about the error.

idstringrequired

A unique, stable identifier for this specific error.

invalidPropertyValueobject19 fields

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.

invalidValuestring

The raw string value from the import file that caused the validation failure.

invalidValueToDisplaystring

A convenience accessor that returns either the value from `invalidPropertyValue` or `invalidValue`, whichever is present (preferring the property value).

knownColumnNumberinteger (int32)

The zero-based column index in the import file where the error occurred

objectTypestring

The CRM object type affected by this error.

One ofABANDONED_CARTACCEPTANCE_TESTADAD_ACCOUNTAD_CAMPAIGNAD_GROUPAI_FORECASTALL_PAGESAPPROVALAPPROVAL_STEPATTRIBUTIONAUDIENCEAUTOMATION_JOURNEYAUTOMATION_PLATFORM_FLOWAUTOMATION_PLATFORM_FLOW_ACTIONBET_ALERTBET_DELIVERABLE_SERVICEBLOG_LISTING_PAGEBLOG_POSTCALLCAMPAIGNCAMPAIGN_BUDGET_ITEMCAMPAIGN_SPEND_ITEMCAMPAIGN_STEPCAMPAIGN_TEMPLATECAMPAIGN_TEMPLATE_STEPCARTCASE_STUDYCHATFLOWCLIPCMS_URLCOMBO_EVENT_CONFIGURATIONCOMMERCE_PAYMENTCOMMUNICATIONCOMPANYCONTACTCONTACT_CREATE_ATTRIBUTIONCONTENTCONTENT_AUDITCONTENT_AUDIT_PAGE

objectTypeIdstring

The modern object type identifier for the CRM object affected by this error.

sourceDataobjectrequired6 fields

json

{
  "results": [
    {
      "createdAt": 0,
      "errorType": "AMBIGUOUS_ENUMERATION_OPTION",
      "id": "string",
      "sourceData": {
        "additionalRowData": [
          "string"
        ],
        "containsEncryptedProperties": false,
        "fileId": 0,
        "lineNumber": 0,
        "rowData": [
          "string"
        ],
        "pageName": "string"
      },
      "errorMessage": "string",
      "extraContext": "string",
      "invalidPropertyValue": {
        "dataSensitivity": "high",
        "isEncrypted": false,
        "isLargeValue": false,
        "name": "string",
        "persistenceTimestamp": 0,
        "requestId": "string",
        "selectedByUser": false,
        "selectedByUserTimestamp": 0,
        "source": "ACADEMY",
        "sourceId": "string",
        "sourceLabel": "string",
        "sourceMetadata": "string"
      },
      "invalidValue": "string",
      "invalidValueToDisplay": "string",
      "knownColumnNumber": 0,
      "objectType": "ABANDONED_CART",
      "objectTypeId": "string"
    }
  ],
  "paging": {
    "next": {
      "after": "string",
      "link": "string"
    }
  }
}

Need more? See the HubSpot guide for connection setup and behaviour shared by every action.

Was this page helpful?