Storefront: Add Cart Items

Add one or more products to an existing BigCommerce cart via the Storefront GraphQL API — the mutation is editable, so you decide exactly what comes back

Use it in a workflow

Add a step and choose the BigCommerce Storefront connector.
Pick the Storefront: Add Cart Items action (under bigcommerce).
Fill in the fields below, then reference the result from later steps as {{storefrontAddCartItems.response.data}}.

Fields

querystring

Editable GraphQL mutation sent to the Storefront API.

Default "mutation BCAddCartItems($input: AddCartLineItemsInput!) {\n cart {\n addCartLineItems(input: $input) {\n cart {\n entityId\n lineItems {\n physicalItems { entityId name quantity extendedSalePrice { value currencyCode } }\n }\n amount { value currencyCode }\n discountedAmount { value currencyCode }\n }\n errors {\n ... on CartItemProductNotFoundError { message }\n ... on CartItemVariantNotFoundError { message }\n }\n }\n }\n}"

variablesstring

JSON object of mutation variables — set input.cartEntityId and input.data.lineItems.

Default "{\n \"input\": {\n \"cartEntityId\": \"b20d7fba-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\n \"data\": {\n \"lineItems\": [\n { \"quantity\": 1, \"productEntityId\": 123, \"variantEntityId\": 456 }\n ]\n }\n }\n}"

fullResponseboolean

Return BigCommerce's whole { data, errors } body and status unchanged — for passing a response straight back to a GraphQL client. When off, data is unwrapped (read fields at response.data.<field>) and GraphQL errors fail the step.

Default false

forwardAllHeadersboolean

If enabled, all headers from the incoming request will be forwarded to BigCommerce. Headers below override forwarded ones.

Default false

headerskeyvalue

HTTP headers to include in the request to BigCommerce

Need more? See the BigCommerce Storefront guide for connection setup and behaviour shared by every action.

Was this page helpful?