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-03/{importId}/errors

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/crm/imports/2026-03/{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-03e64c763e4eabRevision changes
    • warning

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

  • 2026-03821ae21c4921Revision changes
    • info

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