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

# Create Import

`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`

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-09-03** (2026-09) `8c1d8b465db8`: 1 breaking, 2 info
  - the `importTemplate/templateId` response's property format changed from `int32` to `int64` for status `200`
  - api operation id `post-/crm/imports/2026-09_/crm/imports/2026-09` removed and replaced with `post-/crm/imports/2026-09_/crm/imports/v3`
  - the endpoint scheme security `private_apps` was removed from the API

[Operation history](https://skmtc.dev/hubspot/apis/crm-imports/changes/crm/imports/2026-09/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/447517f327fb?raw)