HUhubspot
Advanced

Create Import

Changed on

Create a new import in your HubSpot account by uploading files and specifying import settings. This endpoint allows you to initiate the import process by providing the necessary files and configuration details.

post/crm/imports/2026-09

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/crm/imports/2026-09
  • Auth
    OAuth 2
    Authorization code: https://app.hubspot.com/oauth/authorize
    Token URL: https://api.hubapi.com/oauth/v1/token scopes: crm.import

Request body multipart/form-data

filesstring binary
importRequeststring

Response

successful operation

createdAtstring date-time required

The timestamp when the object was created, in ISO 8601 format.

idstring required

The unique identifier for this import.

importNamestring

The user-provided name for this import.

importRequestJsonobject

The complete import request configuration as a JSON object.

importSource'API' | 'CRM_UI' | 'IMPORT' | 'MOBILE_ANDROID' | 'MOBILE_IOS' | 'SALESFORCE'

Indicates where/how the import was initiated.

mappedObjectTypeIdsstring[] required

An array of object type IDs that are mapped during the import.

optOutImportboolean required

Whether or not the import is a list of people disqualified from receiving emails.

state'CANCELED' | 'DEFERRED' | 'DONE' | 'FAILED' | 'PROCESSING' | 'REVERTED' | 'STARTED' required

The status of the import.

updatedAtstring date-time required

The timestamp when the import record was last updated, formatted as an ISO 8601 instant.

Changes

  • 2026-098c1d8b465db8Revision changes
    • breaking

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

    • info

      api operation id post-/crm/imports/2026-09_/crm/imports/2026-09 removed and replaced with post-/crm/imports/2026-09_/crm/imports/v3

    • info

      the endpoint scheme security private_apps was removed from the API