Carts

Use the carts API to create and manage data related to ecommerce purchases in HubSpot. This can be especially useful for keeping HubSpot data synced with external ecommerce platforms, such as Shopify and NetSuite.

For example, use the API to sync cart data with Shopify, including associating the cart with an order and contact record.

To create a cart, make a POST request to crm/v3/objects/cart.

In the request body, you can include the properties and associations objects to set property values and associate the cart with other CRM objects (e.g., contacts and line items). Learn more about order properties and associations below.

Cart details are stored in cart properties. HubSpot provides a set of default cart properties, but you can also create your own custom properties using the properties API.

To include properties when creating a cart, add them as fields in a properties object in the request body.For example, the request body below would create a cart with some basic product details based on the information provided by the buyer at checkout.

The response will include the information you provided during creation along with a few other default properties.

You can associate carts with other HubSpot CRM objects at creation by including an associations object. You can also use the associations API to update existing carts after creation.

In the associations array, include the following fields:

For example, the POST request body below would create a cart that's associated with a specific contact and two line items. 

Depending on the information you need, there are a few ways to retrieve carts:

• To retrieve all carts, make a GET request to /crm/v3/objects/cart.
• To retrieve a specific cart, make a GET request to the above URL and specify a cart ID. For example: /crm/v3/objects/cart/44446244097.
• To retrieve carts that meet a specific set of criteria, you can make a POST request to the search endpoint and include filters in the request body. Learn more about searching the CRM.

The response will include a few default properties, including the create date, last modified date.

To return specific properties, include a properties query parameter in the request URL along with comma-separated property names. For example, making a GET request to the following URL would result in the response below:

/crm/v3/objects/cart?properties=hs_external_cart_id&hs_external_status

To view all available cart properties, use the properties API by making a GET request to crm/v3/properties/cart.

Learn more about cart properties.

You can use the search endpoint to retrieve carts that meet a specific set of filter criteria. This will be a POST request that includes your filter criteria in the request body.

For example, to search for all carts placed at a specific store, you would make a POST request to crm/v3/objects/cart/search with the following request body:

Note that the filters array specifies the search criteria, while the properties array specifies which properties to return.

To update a cart, make a PATCH request to /crm/v3/objects/cart/{cartId}. In the request body, include a properties object containing the properties that you want to update. 

For example, if you wanted to update a cart after it's been fulfilled, you could send the following request body:

The response will include a set of default properties along with the property that you just set.

To update the associations for an existing cart, make a PUT request to /crm/v3/objects/cart/{cartId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}. You can also use the associations API.

For example, to associate a cart with an existing order, you would make a PUT request to the following URL:

/crm/v3/objects/cart/{cartId}/associations/order/{orderId}/592

The response will return a set of default properties along with an associations object containing information about the association that you set.

To remove an association from an existing cart, make a DELETE request to the following URL:

/crm/v3/objects/cart/{cartId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}

For example, if you wanted to remove an associated line item from a cart, your request URL would be the following:

/crm/v3/objects/cart/{cartId}/associations/line_items/{lineItemId}/590

When managing your cart data, you may want to use some of the common properties in the table below. To get all cart properties, make a GET request to /crm/v3/properties/cart. Learn more about using the properties API.