{"templateId":"markdown","versions":[{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/sales-orders/create-sales-order-manually","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/sales-orders/create-sales-order-manually","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/sales-orders/create-sales-order-manually","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Create a Sales Order Manually","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":"create-a-sales-order-manually","__idx":0},"children":["Create a Sales Order Manually"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ShipEngine API allows users to create sales orders manually via the API. At minimum, you need:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_order_id"]}]},{"$$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"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also provide additional sales order information."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-api-request","__idx":1},"children":["Example API Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /v-beta/sales_orders"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v-beta/sales_orders 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  \"external_order_id\": \"1111\",\n  \"external_order_number\": \"2222\",\n  \"order_source\": {\n    \"order_source_id\": \"9ab83300-39ba-4159-96f8-0d0ef6dfcbfa\"\n  },\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\": \"amanda@example.com\"\n  },\n  \"bill_to\": {\n    \"email\": \"amanda@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    {\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}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"order-source","__idx":2},"children":["Order Source"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can leave ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order_source"]}," empty - a default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api"]}," order source will be created automatically if none exists. If you have multiple ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api"]}," order sources, you must specify which to use."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can only create sales orders via API with an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api"]}," order source. Third-party sources like Amazon or Shopify must be imported by connecting that order source."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"shipping-addresses","__idx":3},"children":["Shipping Addresses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can specify ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ship_to"]}," address either for the entire sales order or for individual items. If specified at the order level, it applies to all items. You may specify both as long as addresses are identical."]}]},"headings":[{"value":"Create a Sales Order Manually","id":"create-a-sales-order-manually","depth":1},{"value":"Example API Request","id":"example-api-request","depth":2},{"value":"Order Source","id":"order-source","depth":2},{"value":"Shipping Addresses","id":"shipping-addresses","depth":2}],"frontmatter":{"seo":{"title":"Create a Sales Order Manually"}},"lastModified":"2026-07-29T23:05:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/sales-orders/create-sales-order-manually","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}