{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/reference/create-label","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/reference/create-label","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/reference/create-label","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Create Label","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-label","__idx":0},"children":["Create Label"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You'll use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["/v1/labels/"]}," endpoint to purchase a label from your desired carrier. The response returns a label for the specified carrier and service class and includes the tracking number you'll use to track the shipment."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you are new to ShipStation API, make sure you read the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/create-a-label"},"children":["Create a Shipping Label"]}," documentation first. It provides a step-by-step guide on creating your first label with ShipStation API."]},{"$$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/"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/labels HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n\t\"shipment\": {\n        \"validate_address\": \"validate_and_clean\",\n        \"service_code\": \"usps_priority_mail\",\n\t\t\"ship_from\": {\n\t\t\t\"name\": \"John Doe\",\n\t\t\t\"company_name\": \"Example Corp.\",\n\t\t\t\"address_line1\": \"4009 Marathon Blvd\",\n\t\t\t\"city_locality\": \"Austin\",\n\t\t\t\"state_province\": \"TX\",\n\t\t\t\"postal_code\": \"78756\",\n\t\t\t\"country_code\": \"US\",\n\t\t\t\"phone\": \"512-555-5555\",\n            \"email\": \"sender@example.com\"\n\t\t},\n\t\t\"ship_to\": {\n\t\t\t\"name\": \"Amanda Miller\",\n\t\t\t\"address_line1\": \"525 S Winchester Blvd\",\n\t\t\t\"city_locality\": \"San Jose\",\n\t\t\t\"state_province\": \"CA\",\n\t\t\t\"postal_code\": \"95128\",\n\t\t\t\"country_code\": \"US\",\n            \"email\": \"recipient@example.com\"\n\t\t},\n\t\t\"packages\": [\n\t\t\t{\n\t\t\t\t\"weight\": {\n\t\t\t\t\t\"value\": 17,\n\t\t\t\t\t\"unit\": \"pound\"\n\t\t\t\t},\n\t\t\t\t\"dimensions\": {\n\t\t\t\t\t\"length\": 36,\n\t\t\t\t\t\"width\": 12,\n\t\t\t\t\t\"height\": 24,\n\t\t\t\t\t\"unit\": \"inch\"\n\t\t\t\t}\n\t\t\t}\n\t\t]\n\t}\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-392157963\",\n    \"status\": \"completed\",\n    \"shipment_id\": \"se-1053748895\",\n    \"ship_date\": \"2023-12-20T08:00:00Z\",\n    \"created_at\": \"2023-12-20T18:02:07.7650796Z\",\n    \"shipment_cost\": {\n        \"currency\": \"usd\",\n        \"amount\": 175.0400\n    },\n    \"insurance_cost\": {\n        \"currency\": \"usd\",\n        \"amount\": 0.0\n    },\n    \"requested_comparison_amount\": {\n        \"currency\": \"usd\",\n        \"amount\": 0.0\n    },\n    \"rate_details\": [\n        {\n            \"rate_detail_type\": \"shipping\",\n            \"carrier_description\": null,\n            \"carrier_billing_code\": \"Base Rate\",\n            \"carrier_memo\": null,\n            \"amount\": {\n                \"currency\": \"usd\",\n                \"amount\": 175.04\n            },\n            \"billing_source\": \"Carrier\"\n        }\n    ],\n    \"tracking_number\": \"9405511899562082413495\",\n    \"is_return_label\": false,\n    \"rma_number\": null,\n    \"is_international\": false,\n    \"batch_id\": \"\",\n    \"carrier_id\": \"se-4712287\",\n    \"service_code\": \"usps_priority_mail\",\n    \"package_code\": \"package\",\n    \"voided\": false,\n    \"voided_at\": null,\n    \"label_format\": \"pdf\",\n    \"display_scheme\": \"label\",\n    \"label_layout\": \"4x6\",\n    \"trackable\": true,\n    \"label_image_id\": null,\n    \"carrier_code\": \"stamps_com\",\n    \"tracking_status\": \"in_transit\",\n    \"label_download\": {\n        \"pdf\": \"https://api.shipengine.com/v1/downloads/10/wpTzhiFW9ke8L-_6rJHmEA/label-392157963.pdf\",\n        \"png\": \"https://api.shipengine.com/v1/downloads/10/wpTzhiFW9ke8L-_6rJHmEA/label-392157963.png\",\n        \"zpl\": \"https://api.shipengine.com/v1/downloads/10/wpTzhiFW9ke8L-_6rJHmEA/label-392157963.zpl\",\n        \"href\": \"https://api.shipengine.com/v1/downloads/10/wpTzhiFW9ke8L-_6rJHmEA/label-392157963.pdf\"\n    },\n    \"form_download\": null,\n    \"qr_code_download\": null,\n    \"insurance_claim\": null,\n    \"packages\": [\n        {\n            \"package_id\": 410478985,\n            \"package_code\": \"package\",\n            \"weight\": {\n                \"value\": 17.00,\n                \"unit\": \"pound\"\n            },\n            \"dimensions\": {\n                \"unit\": \"inch\",\n                \"length\": 36.00,\n                \"width\": 12.00,\n                \"height\": 24.00\n            },\n            \"insured_value\": {\n                \"currency\": \"usd\",\n                \"amount\": 0.00\n            },\n            \"tracking_number\": \"9405511899562082413495\",\n            \"qr_code_download\": null,\n            \"label_messages\": {\n                \"reference1\": null,\n                \"reference2\": null,\n                \"reference3\": null\n            },\n            \"external_package_id\": null,\n            \"content_description\": null,\n            \"sequence\": 1,\n            \"alternative_identifiers\": []\n        }\n    ],\n    \"charge_event\": \"carrier_default\",\n    \"alternative_identifiers\": []\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOTE:"]}," ","This example request and response includes the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validate_address"]}," property, which customers on the Free plan can use to access the address validation functionality. The Advanced plan and above also have access to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/addresses/validation"},"children":["validate address endpoint"]}," that allows you to validate addresses separately from purchasing a label."]}]}]},"headings":[{"value":"Create Label","id":"create-label","depth":1},{"value":"Example Request & Response","id":"example-request--response","depth":2}],"frontmatter":{"seo":{"title":"Create Label"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/reference/create-label","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}