{"templateId":"markdown","versions":[{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/sales-orders/create-label-from-order","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/sales-orders/create-label-from-order","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/sales-orders/create-label-from-order","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Create a Label from 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":"create-a-label-from-a-sales-order","__idx":0},"children":["Create a Label from a Sales Order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide explains how to create a shipping label from a sales order ID using the ShipEngine API beta endpoint."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before using this endpoint, you need to be familiar with:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/sales-orders/get-started-with-orders"},"children":["Getting started with orders"]}," and the Sales Order API"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["How to obtain a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}," by listing carriers"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["How to get a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["service_code"]}," by listing carrier services"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-endpoint","__idx":2},"children":["API Endpoint"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /v-beta/labels/sales_order/:sales_order_id"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-request","__idx":3},"children":["Example Request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v-beta/labels/sales_order/:sales_order_id 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  \"label_format\": \"pdf\",\n  \"shipment\": {\n    \"carrier_id\": \"se-123890\",\n    \"service_code\": \"usps_priority_mail\",\n    \"ship_from\": {\n      \"company_name\": \"Example Corp.\",\n      \"name\": \"John Doe\",\n      \"phone\": \"111-111-1111\",\n      \"address_line1\": \"4009 Marathon Blvd\",\n      \"city_locality\": \"Austin\",\n      \"state_province\": \"TX\",\n      \"postal_code\": \"78756\",\n      \"country_code\": \"US\"\n    },\n    \"packages\": [{\n      \"package_code\": \"package\",\n      \"weight\": {\n        \"value\": 2,\n        \"unit\": \"pound\"\n      }\n    }]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-structure","__idx":4},"children":["Response Structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API returns a comprehensive label object containing:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment_id"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Shipment and insurance costs in USD"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Tracking number"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Label format and layout specifications"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Download link for the label PDF"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Package details with dimensions and weight"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Status information (completed, voided, trackable, etc.)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-response-fields","__idx":5},"children":["Key Response Fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response includes boolean flags like:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_return_label"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_international"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["voided"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["trackable"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["And detailed cost breakdowns for both shipment and insurance."]}]},"headings":[{"value":"Create a Label from a Sales Order","id":"create-a-label-from-a-sales-order","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"API Endpoint","id":"api-endpoint","depth":2},{"value":"Example Request","id":"example-request","depth":2},{"value":"Response Structure","id":"response-structure","depth":2},{"value":"Key Response Fields","id":"key-response-fields","depth":2}],"frontmatter":{"seo":{"title":"Create a Label from a Sales Order"}},"lastModified":"2026-07-29T23:05:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/sales-orders/create-label-from-order","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}