POST

Bulk Update Orders

Updates properties of up to 100 orders.

Currently, only the following fields can be updated:

  • order.buyerInfo.email
  • order.buyerLanguage
  • order.weightUnit
  • order.billingInfo.address
  • order.billingInfo.contactDetails
  • order.archived
  • order.attributionSource
  • order.seenByAHuman
  • order.recipientInfo.address
  • order.recipientInfo.contactDetails
  • order.shippingInfo.logistics.shippingDestination.address
  • order.shippingInfo.logistics.shippingDestination.contactDetails
  • order.extendedFields

To update a field's value, include the new value in the order object in the body params. To remove a field's value, pass null.

Notes:

  • Removing (passing null to) buyerInfo or contactDetails results in an error.
  • archived can be set to true or false, but its value can't be removed.
  • Orders that fail validation are reported in results[i].itemMetadata.error, while the remaining orders are updated.

To update an order's payment status, use Update Payment Status.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permission Scopes
Manage Orders
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/ecom/v1/bulk/orders/update
Errors

This method doesn't return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Event TriggersThis method triggers the following events:
Order Updated
Did this help?