---
title: "Cancel an active import"
method: POST
path: "/crm/imports/2026-09/{importId}/cancel"
tags: ["Advanced"]
---

# Cancel an active import

`POST /crm/imports/2026-09/{importId}/cancel`

## Request

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

This allows a developer to cancel an active import.

## Path parameters

- `importId` integer, required

## Response `200`

successful operation

- ActionResponse
  - `completedAt` string, date-time, required: The timestamp when the action was completed, in ISO 8601 format.
  - `links` object: A map of link names to associated URIs containing documentation about the error or recommended remediation steps
  - `requestedAt` string, date-time: The timestamp when the export request was made, in ISO 8601 format.
  - `startedAt` string, date-time, required: The timestamp when the action was started, in ISO 8601 format.
  - `status` 'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING', required: An enum representing the lifecycle state of the action.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-09-03** (2026-09) `8c1d8b465db8`: 2 info
  - api operation id `post-/crm/imports/2026-09/{importId}/cancel_cancel` removed and replaced with `post-/crm/imports/2026-09/{importId}/cancel_/crm/imports/v3/{importId}/cancel`
  - 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/:importId/cancel/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)