Cart Item Updated Event

Event Type: cart.item_updated

When sent: When a customer changes the quantity of an item in their cart.

Not sent when: Cart items are updated via SDK API calls.

This webhook includes the updated item details, previous quantity, and updated cart summary.

Example webhook payload

Webhook Payload Schema

Cart item updated event data

Property

Type

Description

storeIdrequired

string (uuid)

Store identifier

customerId

string (uuid)

Customer identifier

occurredAtrequired

string (date-time)

When the event occurred

externalReference

string

External reference for tracking

cartIdrequired

string (uuid)

Cart identifier

itemrequired

object

Cart item DTO for webhook events

previousQuantityrequired

integer (int32)

Previous quantity

cartSummaryrequired

object

Cart summary DTO for webhook events