Cart Delivery Address Management

We've refined and improved how delivery addresses are handled by making deliveryAddresses a required input field within a new delivery object.

As of API version 2025-01, the deliveryAddressPreferences field on the CartBuyerIdentity object is deprecated. Use the new addresses field on the CartDelivery object instead.

We've added the following new mutations for managing delivery addresses on carts:

• cartDeliveryAddressesAdd
• cartDeliveryAddressesUpdate
• cartDeliveryAddressesRemove

For cart delivery addresses, you can set an address as selected to indicate that delivery rates should be calculated. This improves performance by avoiding unnecessary rate generation. It also ensures that addresses are synchronized between Checkout and Cart, maintaining a single source of truth for any updates or changes.

We recommend reviewing your current integration and preparing to adopt the new field and mutations.