Fixed
Clearer rules for order names, custom properties, order source and duplicate products
November 16th, 2026
- Customer names: Create order, Update order and Send aggregated order info no longer say
first_nameandlast_nameare required. The API accepts an order without them. If both are empty, the order is saved but no review request is sent, and one name is enough. To send the request later, add a name with Update order. - Custom properties: order and line-item
custom_propertiesvalues are strings, includingsuppress_review_requestandcoupon_used. Booleans and numbers are still accepted and are stored and returned as strings (truecomes back as"true"). The examples now send"true". - Order source:
sourceon Retrieve orders and Retrieve order by ID is read-only and shows the path that last wrote the order. The known values are listed. - Duplicate products: the Idempotency guide now says that creating a product with an existing
external_idreturns409(product already exists) and doesn't update it. To apply changes, look the product up withexternal_idsand update it with Update product. The guide also no longer shows a productPUTorDELETE, which the API doesn't have. - Add product to collection: Add product to collection takes
external_idas a string. A number is matched as its text form.
