There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API Keys are being deprecated and are no longer supported. Continued use of HubSpot API Keys is a security risk to your account and data. Your API Keys could be deactivated at any time after Nov. 30th, and we recommend that you migrate to Private Apps as soon as possible so you do not lose business-critical functionality.

Import ecommerce data

Last updated June 17, 2020

POST /extensions/ecomm/v2/imports/page

Method Details

HTTP Methods:


Content Type:


Response Format:


Requires Authentication?


Rate Limited?






Required Scope:


Import a page of ecommerce data upon customer request.

Up to 200 import messages can be included in a single request.

Required Parameters How to use Description
OAuth Access Token or API Key Authorization: Bearer {token} header
or hapikey={key} query parameter.
Used to authenticate the request. Please see this page for more details about authentication.
importStartedAt   In request body JSON  Timestamp from the webhook when the customer requested imported in HubSpot UI
 pageNumber In request body JSON  Integer starting at zero of the page number for that objectType
 messages In request body JSON Array of sync messages for this page of imports. Up to 200 messages can be included.
 storeId In request body JSON The key of the store for this import
objectType In request body JSON The HubSpot object this page of imports is for. Must be one of CONTACT, DEAL, LINE_ITEM or PRODUCT

If successful you will receive 204 No Content response.