--- schema_version: "1" id: b6f0347fc36010e97fc2e7e1293c11e8ceb4f61841fda262c37b6b1e909959fc title: Add Cart Item Action collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/flow_ref_elements_comm_actions_add_cart_item.md canonical_url: https://help.salesforce.com/s/articleView?id=platform.flow_ref_elements_comm_actions_add_cart_item.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: f1fee19c2dd61ccb8c48095f6724124afe7af33de11b6cc15f1b7a71692d09dc description: In a B2B Commerce Checkout flow, add an item to a cart. products: - Flow Builder - Salesforce Platform release: "264" --- # Add Cart Item Action In a B2B Commerce Checkout flow, add an item to a cart. ### Required Editions
Available in: Lightning Experience
View supported editions.
![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png) Note Cart actions aren’t available in flows for B2B stores built on an Aura template. To build a B2B Commerce Checkout flow for an Aura store, see [B2B Commerce Checkout Flow (Aura)](https://developer.salesforce.com/docs/commerce/salesforce-commerce/guide/b2b-b2c-comm-setup-checkout-flow.html). In Flow Builder, add an Action element to your flow. Select the **Commerce** category, and search for **Add Cart Item**. To access this action from REST API, use the name `addCartItem`. ## Set Input Values Use values from earlier in the flow to set the inputs.
Input Parameter Description
Cart State or ID ID of the cart or state of the cart to add an item to. Valid state values are: active and current. A current cart is not closed or pending deletion.
effectiveAccountId (Optional) ID of the buyer account or guest buyer profile for which the request is made. If unspecified, the default value is determined from context.
Web Store ID The ID of the web store.
Cart Item Input

This input is an Apex-defined variable of class ConnectApi.CartItemInput, which includes these fields:

  • productId — ID of the product.
  • quantity — Quantity of the cart item. Use a value that can be converted to BigDecimal.
  • type — Type of the cart item. The only valid value is Product.
## Store Output Values Use output values later in the flow. The values are assigned when the item is created.
Output Parameter Description
Added Cart Item

This output is an Apex-defined variable of class ConnectApi.CartItem, which includes these fields:

  • itemizedAdjustment​Amount — Total itemized adjustment amount for the item, including promotions and excluding taxes.
  • listPrice — List price for the item.
  • salesPrice — Sales price for the item.
  • totalAdjustmentAmount — Adjustments made to the unit price for the item. This value is informational only and isn’t used in pricing calculations.
  • totalAmount — Total amount for the item.
  • totalListPrice — Total list price for the item.
  • totalPrice — Total price for the item including adjustments but excluding taxes.
  • totalTax — Total tax for the item.
  • unitAdjustedPrice — Unit price, including adjustments, for the item. This value is informational only and isn’t used in pricing calculations.
  • unitAdjustmentAmount — Total amount including discounts, but excluding shipping and tax, for product items in the cart.
## Error Conditions
Error Condition Description

The user doesn’t have access to the cart.

Error Message: You don't have access to this cart. If possible, contact the admin for this web store.

Error Code: INSUFFICIENT_ACCESS_OR_READONLY

HTTP Status Code: 400