{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/orders/create-update-order","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/orders/create-update-order","default":false,"active":false,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/orders/create-update-order","default":false,"active":true,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml","oas-apis/@shipstation-v1/openapi.yaml":"oas-apis/@shipstation-v1/openapi.yaml"},"props":{"metadata":{"markdoc":{"tagList":["openapi-code-sample","replay-openapi"]},"type":"markdown"},"seo":{"title":"Create/Update 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":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"createupdate-order","__idx":0},"children":["Create/Update Order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can use this method to create a new order ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["or"]}," update an existing order. If the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orderKey"]}," is specified, ShipStation will attempt to locate the order with the specified ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orderKey"]},". If found, the existing order with that key will be updated. If the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orderKey"]}," is not found, a new order will be created with that ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orderKey"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["split orders"]},", ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipstation-v1/docs/models/advanced-options"},"children":["see the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mergedOrSplit"]}," property in Advanced Options"]},". This property (key) is always required for merged or split orders."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This call does not currently support partial updates. The entire resource must be provided in the body of the request."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOTE"]}," Only orders in an open status in ShipStation (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["awaiting_payment"]},",",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["awaiting_shipment"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["on_hold"]},") can be updated through this method. Orders in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancelled"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipped"]}," states may not be updated. The body of this request should specify an ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipstation-v1/docs/models/order"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Order"]}]}," object."]}]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-apis/@shipstation-v1/openapi.yaml","operationId":"create_update_order","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"ReplayOpenApi","attributes":{"descriptionFile":"oas-apis/@shipstation-v1/openapi.yaml","operationId":"create_update_order","parameters":{},"options":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-resources","__idx":1},"children":["Related Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipstation-v1/docs/models/order"},"children":["Order Model"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See all order endpoints in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipstation-v1/openapi"},"children":["Full API Reference"]}]}]}]},"headings":[{"value":"Create/Update Order","id":"createupdate-order","depth":1},{"value":"Related Resources","id":"related-resources","depth":2}],"frontmatter":{"seo":{"title":"Create/Update Order"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipstation-v1/docs/orders/create-update-order","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}