Skip to main content

Create Merged Shipment

POST 
/api/v2/merged-shipments

Merges two or more sales orders into a single physical shipment (merge group). Each underlying sales order remains intact; one fulfillment per SO is created and linked to the new merge group. The lowest-ID order is the primary.

Authentication: Requires Bearer token.

Request Body:

  • sales_order_ids (required, integer[]): Two or more sales order IDs to merge
  • notes (optional, string, max 2000): Free-form notes attached to the merge group
  • acknowledge_warnings (optional, boolean): If true, allows merging despite warnings (e.g. ship-by date variance). Blockers always prevent merging.

Request​

Responses​

Successful response