HUhubspot
Basic

Retrieve errors for a specific import

Changed on

Retrieves detailed error records for a specific import operation, enabling you to identify and troubleshoot records that failed during processing.

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

Path parameters

importIdinteger required

The unique identifier of the import for which to retrieve errors.

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

A boolean indicating whether to include detailed error messages in the response.

includeRowDataboolean

A boolean indicating whether to include the row data associated with each error in the response.

limitinteger

The maximum number of results to display per page.

Response

successful operation

Changes

  • 2026-09447517f327fbRevision changes
    • info

      added the required property ////// to the response with the status

  • 2026-098c1d8b465db8Revision changes
    • breaking

      the // response's property format changed from int32 to int64 for status

    • breaking

      the /// response's property format changed from int32 to int64 for status

    • warning

      added the new BREEZE_AGENT enum value to the /// response property for the response status

    • warning

      added the new CONNECTED_ACCOUNT enum value to the /// response property for the response status

    • warning

      added the new CUSTOMER_PORTAL enum value to the /// response property for the response status

    • warning

      added the new DI_WRITE_TO_CRM enum value to the /// response property for the response status

    • warning

      added the new INVALID_PROPERTY_VALUE_FORMAT enum value to the // response property for the response status

    • warning

      added the new LINE_ITEM_MULTIPLE_PARENTS_IN_ROW enum value to the // response property for the response status

    • warning

      added the new MARKETS enum value to the /// response property for the response status

    • warning

      added the new REVENUE_PLATFORM enum value to the /// response property for the response status

    • info

      api operation id get-/crm/imports/2026-09/{importId}/errors_getErrors removed and replaced with get-/crm/imports/2026-09/{importId}/errors_/crm/imports/v3/{importId}/errors

    • info

      the endpoint scheme security private_apps was removed from the API

    • info

      added the required property /// to the response with the status