{"templateId":"markdown","versions":[{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/reference/update-order","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/reference/update-order","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/reference/update-order","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Update a Sales Order","keywords":"shipping, labels, shipstation, documentation, api","siteUrl":"https://docs.shipstation.com","lang":"en-US","llmstxt":{"hide":false,"title":"ShipStation API LLM Docs","description":"Find links and references to all markdown documentation for use with LLMs","excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"update-a-sales-order","__idx":0},"children":["Update a Sales Order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ShipEngine allows users to update sales orders manually via the API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"minimum-required-information","__idx":1},"children":["Minimum Required Information"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order_date"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ship_to"]}," for every sales order item, if any"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"important-notes","__idx":2},"children":["Important Notes"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your sales order will be completely replaced with the information you provide in the request. Key identifying information like ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_order_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order_source"]}," cannot be changed."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-endpoint","__idx":3},"children":["API Endpoint"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PUT /v-beta/sales_orders/:sales_order_id"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-request","__idx":4},"children":["Example Request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"PUT /v-beta/sales_orders/32e18d70-52e0-5002-ab7a-ae33843c2187 HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"order_date\": \"2019-07-25T15:24:46.657Z\",\n  \"payment_details\": {\n    \"subtotal\": {\"currency\": \"usd\", \"amount\": 200},\n    \"estimated_shipping\": {\"currency\": \"usd\", \"amount\": 10},\n    \"estimated_tax\": {\"currency\": \"usd\", \"amount\": 5},\n    \"grand_total\": {\"currency\": \"usd\", \"amount\": 215}\n  },\n  \"customer\": {\n    \"name\": \"Amanda Miller\",\n    \"phone\": \"555-555-5555\",\n    \"email\": \"example@example.com\"\n  },\n  \"bill_to\": {\n    \"email\": \"example@example.com\",\n    \"address\": {\n      \"name\": \"Amanda Miller\",\n      \"phone\": \"555-555-5555\",\n      \"address_line1\": \"525 S Winchester Blvd\",\n      \"city_locality\": \"San Jose\",\n      \"state_province\": \"CA\",\n      \"postal_code\": \"95128\",\n      \"country_code\": \"US\",\n      \"address_residential_indicator\": \"yes\"\n    }\n  },\n  \"ship_to\": {\n    \"name\": \"Amanda Miller\",\n    \"phone\": \"555-555-5555\",\n    \"address_line1\": \"525 S Winchester Blvd\",\n    \"city_locality\": \"San Jose\",\n    \"state_province\": \"CA\",\n    \"postal_code\": \"95128\",\n    \"country_code\": \"US\",\n    \"address_residential_indicator\": \"yes\"\n  },\n  \"sales_order_items\": [{\n    \"sales_order_item_id\": \"02202633-d038-5cfc-bdc2-777968435771\",\n    \"line_item_details\": {\n      \"name\": \"ball of string A\",\n      \"sku\": \"ball of string A\"\n    },\n    \"price_summary\": {\n      \"unit_price\": {\"currency\": \"usd\", \"amount\": 200}\n    },\n    \"ship_to\": {\n      \"name\": \"Amanda Miller\",\n      \"phone\": \"555-555-5555\",\n      \"address_line1\": \"525 S Winchester Blvd\",\n      \"city_locality\": \"San Jose\",\n      \"state_province\": \"CA\",\n      \"postal_code\": \"95128\",\n      \"country_code\": \"US\",\n      \"address_residential_indicator\": \"yes\"\n    },\n    \"quantity\": 4,\n    \"is_gift\": false\n  }]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-limitations","__idx":5},"children":["Key Limitations"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"updating-sales-order-items","__idx":6},"children":["Updating Sales Order Items"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can only update existing sales order items"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cannot add or remove items from a sales order"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include all items in your request, even unchanged ones"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Items are identified by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sales_order_item_id"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"order-source-restrictions","__idx":7},"children":["Order Source Restrictions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You may only use the API to update sales orders with an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api"]}," order source. Amazon or Shopify orders must be updated through their respective platforms."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"shipping-addresses","__idx":8},"children":["Shipping Addresses"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Specify ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ship_to"]}," for the entire order OR for each individual item"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If specified at order level, applies to all items"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Can specify at both levels if addresses are identical"]}]}]},"headings":[{"value":"Update a Sales Order","id":"update-a-sales-order","depth":1},{"value":"Minimum Required Information","id":"minimum-required-information","depth":2},{"value":"Important Notes","id":"important-notes","depth":2},{"value":"API Endpoint","id":"api-endpoint","depth":2},{"value":"Example Request","id":"example-request","depth":2},{"value":"Key Limitations","id":"key-limitations","depth":2},{"value":"Updating Sales Order Items","id":"updating-sales-order-items","depth":3},{"value":"Order Source Restrictions","id":"order-source-restrictions","depth":3},{"value":"Shipping Addresses","id":"shipping-addresses","depth":3}],"frontmatter":{"seo":{"title":"Update a Sales Order"}},"lastModified":"2026-07-29T23:05:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/reference/update-order","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}