{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/labels/create-from-shipment","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/labels/create-from-shipment","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/labels/create-from-shipment","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 Shipment","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-shipment","__idx":0},"children":["Create a Label from a Shipment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you've already ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/create-a-shipment"},"children":["created a shipment"]},", you can create a label using just the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment_id"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Using a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment_id"]}," to create a label is the quickest way to create a label after you've successfully planned your shipment. You can also specify the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/formats"},"children":["label format, size"]},", and ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/downloading"},"children":["download type"]}," to modify the way your label is formatted. You'll simply provide these properties in the body of your request."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-request--response","__idx":1},"children":["Example Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST v1/labels/shipment/:shipment_id"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Similar to the example in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/create-a-label"},"children":["Create a Shipping Label"]},", this example will request a label using the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["USPS"]}," services included with your account. (USPS services are included with US-based ShipStation API accounts. For accounts based in other countries, you can switch to the sandbox to follow along with this tutorial, as Stamps.com USPS services are part of the sandbox for all accounts.)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/labels/shipment/se-2128732 HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"label_format\":\"pdf\",\n  \"label_layout\": \"4x6\",\n  \"label_download_type\": \"url\"\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"label_id\": \"se-test-2128732\",\n  \"status\": \"completed\",\n  \"shipment_id\": \"se-2128732\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\",\n  \"created_at\": \"2019-07-25T18:43:15.038Z\",\n  \"shipment_cost\": {\n    \"currency\": \"usd\",\n    \"amount\": 0.0\n  },\n  \"insurance_cost\": {\n    \"currency\": \"usd\",\n    \"amount\": 0.0\n  },\n  \"tracking_number\": \"9999999999999\",\n  \"is_return_label\": false,\n  \"is_international\": false,\n  \"batch_id\": \"\",\n  \"carrier_id\": \"se-0\",\n  \"service_code\": \"usps_priority_mail\",\n  \"package_code\": \"package\",\n  \"voided\": false,\n  \"voided_at\": null,\n  \"label_format\": \"pdf\",\n  \"label_layout\": \"4x6\",\n  \"trackable\": false,\n  \"carrier_code\": \"stamps_com\",\n  \"tracking_status\": \"unknown\",\n  \"label_download\": {\n    \"pdf\": \"https://api.shipengine.com/v1/downloads/1/s_Tqsu9euEKub6Acc_9UIg/testlabel-2128732.pdf\",\n    \"png\": \"https://api.shipengine.com/v1/downloads/1/s_Tqsu9euEKub6Acc_9UIg/testlabel-2128732.png\",\n    \"zpl\": \"https://api.shipengine.com/v1/downloads/1/s_Tqsu9euEKub6Acc_9UIg/testlabel-2128732.zpl\",\n    \"href\": \"https://api.shipengine.com/v1/downloads/1/s_Tqsu9euEKub6Acc_9UIg/testlabel-2128732.pdf\"\n  },\n  \"form_download\": null,\n  \"insurance_claim\": null\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["And that's it! The label is available for download using any of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_download"]}," URLs provided in the response."]}]},"headings":[{"value":"Create a Label from a Shipment","id":"create-a-label-from-a-shipment","depth":1},{"value":"Example Request & Response","id":"example-request--response","depth":2}],"frontmatter":{"seo":{"title":"Create a Label from a Shipment"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/labels/create-from-shipment","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}