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

# Cancel an active import

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

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/imports/2026-03/{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-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`
- **2026-04-15** (2026-03) `4b50b73891f3`: 4 info
  - the endpoint scheme security `app_cookie` was removed from the API
  - the endpoint scheme security `hapikey` was removed from the API
  - the endpoint scheme security `internal_cookie` was removed from the API
  - the endpoint scheme security `shhkey` was removed from the API
- **2026-04-10** (2026-03) `fc374779b16a`: 8 info
  - api operation id `post-/crm/imports/2026-03/{importId}/cancel` removed and replaced with `post-/crm/imports/2026-03/{importId}/cancel_/crm/imports/v3/{importId}/cancel`
  - the endpoint scheme security `app_cookie` was added to the API
  - the endpoint scheme security `hapikey` was added to the API
  - the endpoint scheme security `internal_cookie` was added to the API
  - …4 more
- **2026-04-03** (2026-03) `ff10b5097ce1`: 1 info
  - api operation id `post-/crm/imports/2026-03/{importId}/cancel_/crm/imports/v3/{importId}/cancel` removed and replaced with `post-/crm/imports/2026-03/{importId}/cancel`
- **2026-03-26** (2026-03) `09a93a62c7b7`: 1 info
  - api operation id `post-/crm/imports/2026-03/{importId}/cancel_cancel` removed and replaced with `post-/crm/imports/2026-03/{importId}/cancel_/crm/imports/v3/{importId}/cancel`

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