{"templateId":"markdown","versions":[{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/sales-orders/create-shipment-with-order-items","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/sales-orders/create-shipment-with-order-items","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/sales-orders/create-shipment-with-order-items","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Create a Shipment with Sales Order Items","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-shipment-with-sales-order-items","__idx":0},"children":["Create a Shipment with Sales Order Items"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide documents how to create a shipment with sales order items using the ShipEngine API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-endpoint","__idx":1},"children":["API Endpoint"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /v-beta/shipments"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-request","__idx":2},"children":["Example Request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v-beta/shipments 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  \"shipments\": [{\n    \"validate_address\": \"validate_and_clean\",\n    \"carrier_id\": \"se-123890\",\n    \"service_code\": \"usps_priority_mail\",\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    \"warehouse_id\": \"se-241419\",\n    \"packages\": [{\n      \"package_code\": \"package\",\n      \"weight\": {\n        \"value\": 1.0,\n        \"unit\": \"ounce\"\n      }\n    }],\n    \"items\": [\n      {\n        \"sales_order_id\": \"0351523b-1955-5259-a5a5-e63b7336e738\",\n        \"sales_order_item_id\": \"eeda0203-1380-5cf3-a6fd-8b405d0e5bfb\",\n        \"quantity\": 1\n      }\n    ]\n  }]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"important-warning","__idx":3},"children":["Important Warning"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When including ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sales_order_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sales_order_item_id"]},", ShipEngine will not automatically populate the SKU and name. Users must manually add SKU and name values if needed, which will then be persisted."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-structure","__idx":4},"children":["Response Structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API returns:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Shipment ID and status"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Address validation results (original vs matched)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Complete shipment details including ship-to, ship-from, and return-to addresses"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Package information"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Items array with timestamps and optional SKU/name fields"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Response includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"has_errors\": false"]}," for successful creation and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"shipment_status\": \"pending\""]}," for new shipments."]}]},"headings":[{"value":"Create a Shipment with Sales Order Items","id":"create-a-shipment-with-sales-order-items","depth":1},{"value":"API Endpoint","id":"api-endpoint","depth":2},{"value":"Example Request","id":"example-request","depth":2},{"value":"Important Warning","id":"important-warning","depth":2},{"value":"Response Structure","id":"response-structure","depth":2}],"frontmatter":{"seo":{"title":"Create a Shipment with Sales Order Items"}},"lastModified":"2026-07-29T23:05:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/sales-orders/create-shipment-with-order-items","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}