---
title: "Create Import"
method: POST
path: "/crm/imports/2026-03"
tags: ["Advanced"]
---

# Create Import

`POST /crm/imports/2026-03`

## Request

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

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.

## Request body `multipart/form-data`

- object
  - `files` string, binary
  - `importRequest` string

## Response `200`

successful operation

- PublicImportResponse
  - `createdAt` string, date-time, required: The timestamp when the object was created, in ISO 8601 format.
  - `id` string, required: The unique identifier for this import.
  - `importName` string: The user-provided name for this import.
  - `importRequestJson` object: 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.
  - `importTemplate` ImportTemplate
    - `templateId` integer, required: The unique identifier for the specific saved template or previous import being referenced.
    - `templateType` 'admin_defined' | 'previous_import' | 'user_file', required: The classification of what type of template this represents, and what is its origin or purpose.
  - `mappedObjectTypeIds` string[], required: An array of object type IDs that are mapped during the import.
  - `metadata` PublicImportMetadata, required
    - `counters` object, required: Summarized outcomes of each row a developer attempted to import into HubSpot.
    - `fileIds` string[], required: The IDs of files uploaded in the File Manager API.
    - `objectLists` PublicObjectListRecord[], required: The lists containing the imported objects.
      - `listId` string, required: The ID of the list containing the imported objects.
      - `objectType` string, required: The type of object contained in the list.
  - `optOutImport` boolean, 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.
  - `updatedAt` string, date-time, required: The timestamp when the import record was last updated, formatted as an ISO 8601 instant.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-06-15** (2026-03) `9e292cea2404`: 2 breaking, 24 warning
  - the `mappedObjectTypeIds/items/` response's property type changed from `object` to `string` for status `200`
  - the `metadata/objectLists/items/objectType` response's property type changed from `object` to `string` for status `200`
  - removed the optional property `mappedObjectTypeIds/items/hubSpotDefinedEventType` from the response with the `200` status
  - removed the optional property `mappedObjectTypeIds/items/hubSpotDefinedObjectType` from the response with the `200` status
  - …22 more
- **2026-06-15** (2026-03) `18a00a1b4dd7`: 2 breaking, 24 info
  - the `mappedObjectTypeIds/items/` response's property type changed from `string` to `object` for status `200`
  - the `metadata/objectLists/items/objectType` response's property type changed from `string` to `object` for status `200`
  - added the optional property `mappedObjectTypeIds/items/hubSpotDefinedEventType` to the response with the `200` status
  - added the optional property `mappedObjectTypeIds/items/hubSpotDefinedObjectType` to the response with the `200` status
  - …22 more
- **2026-05-22** (2026-03) `5447829df914`: 2 info
  - the security scope `crm.import` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm-import` was removed from the endpoint's security scheme `oauth2`
- …earlier changes not shown

[Operation history](https://skmtc.dev/hubspot/apis/crm-imports/changes/crm/imports/2026-03/post.md)

---

[API](https://skmtc.dev/hubspot/apis/crm-imports.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-imports/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-imports/revisions/77773fa56d67?raw)