{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/reference/create-manifest","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/reference/create-manifest","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/reference/create-manifest","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Create Manifest","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-manifest","__idx":0},"children":["Create Manifest"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The page explains how to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/manifests"},"children":["create a manifest"]}," using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/manifests"]}," endpoint and the HTTP POST method."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-explicit-manifest","__idx":1},"children":["Create Explicit Manifest"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You may explicitly specify the labels you want to include in the manifest using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_ids"]}," property."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request--response","__idx":2},"children":["Example Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /v1/manifests"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/manifests HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"label_ids\": [\"se-1049057\", \"se-1049058\"]\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  \"manifests\": [\n    {\n      \"manifest_id\": \"se-11102\",\n      \"form_id\": \"se-11102\",\n      \"created_at\": \"2020-11-05T16:39:34.503Z\",\n      \"ship_date\": \"2020-11-05T00:00:00Z\",\n      \"shipments\": 2,\n      \"label_ids\": [\n        \"se-1049057\",\n        \"se-1049058\"\n      ],\n      \"warehouse_id\": null,\n      \"submission_id\": \"9475711201080308027034\",\n      \"carrier_id\": \"se-82785\",\n      \"manifest_download\": {\n        \"href\": \"https://api-stage.shipengine.com/v1/downloads/0/BpP_fo0d9EiiQJ7hqDQGmA/manifest-11102.pdf\"\n      }\n    }\n  ],\n   \"manifest_requests\": [\n    {\n      \"manifest_request_id\": \"se-28529731\",\n      \"status\": \"in_progress\"\n    }\n   ],\n  \"manifest_id\": \"se-11102\",\n  \"form_id\": \"se-11102\",\n  \"created_at\": \"2020-11-05T16:39:34.503Z\",\n  \"ship_date\": \"2020-11-05T00:00:00Z\",\n  \"shipments\": 2,\n  \"warehouse_id\": null,\n  \"submission_id\": \"9475711201080308027034\",\n  \"carrier_id\": \"se-82785\",\n  \"manifest_download\": {\n    \"href\": \"https://api-stage.shipengine.com/v1/downloads/0/BpP_fo0d9EiiQJ7hqDQGmA/manifest-11102.pdf\"\n  },\n  \"label_ids\": [\n    \"se-1049057\",\n    \"se-1049058\"\n  ],\n  \"request_id\": \"95c1dbc4-0819-4f01-91c5-87183c820b54\",\n  \"errors\": [],\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-implicit-manifests","__idx":3},"children":["Create Implicit Manifests"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Alternately, you may specify the criteria that the labels must meet and ShipStation API will determine which labels to include in the manifest based on that criteria. You may also exclude specific labels from the manifest ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["even if they meet the specified criteria"]}," by using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["excluded_label_ids"]}," property."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you specify an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["excluded_label_ids"]}," property, you must also specify a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/reference/list-carriers"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}]},", ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/reference/create-warehouse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["warehouse_id"]}]},", and ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/ship-dates"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ship_date"]}]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request--response-1","__idx":4},"children":["Example Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example specifies a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["warehouse_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ship_date"]},". If you do not specify ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_ids"]},", you must specify all three of these properties."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /v1/manifests"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/manifests HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n   \"carrier_id\": \"se-82785\",\n   \"warehouse_id\": \"se-107273\",\n   \"ship_date\": \"2020-11-06T00:00:00Z\"\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    \"manifests\": [\n        {\n            \"manifest_id\": \"se-11115\",\n            \"form_id\": \"se-11115\",\n            \"created_at\": \"2020-11-06T20:45:31.65Z\",\n            \"ship_date\": \"2020-11-06T00:00:00Z\",\n            \"shipments\": 2,\n            \"label_ids\": [\n                \"se-1049657\",\n                \"se-1049658\"\n            ],\n            \"warehouse_id\": \"se-107273\",\n            \"submission_id\": \"9475711201080308943358\",\n            \"carrier_id\": \"se-82785\",\n            \"manifest_download\": {\n                \"href\": \"https://api-stage.shipengine.com/v1/downloads/0/bb_mfrWo9kCq-tI643Nz0Q/manifest-11115.pdf\"\n            }\n        }\n    ],\n   \"manifest_requests\": [\n    {\n      \"manifest_request_id\": \"se-28529731\",\n      \"status\": \"in_progress\"\n    }\n   ],\n    \"manifest_id\": \"se-11115\",\n    \"form_id\": \"se-11115\",\n    \"created_at\": \"2020-11-06T20:45:31.65Z\",\n    \"ship_date\": \"2020-11-06T00:00:00Z\",\n    \"shipments\": 2,\n    \"warehouse_id\": \"se-107273\",\n    \"submission_id\": \"9475711201080308943358\",\n    \"carrier_id\": \"se-82785\",\n    \"manifest_download\": {\n        \"href\": \"https://api-stage.shipengine.com/v1/downloads/0/bb_mfrWo9kCq-tI643Nz0Q/manifest-11115.pdf\"\n    },\n    \"label_ids\": [\n        \"se-1049657\",\n        \"se-1049658\"\n    ],\n    \"request_id\": \"61000166-ff79-4924-9897-9dc9389c2301\",\n    \"errors\": [],\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-excluding-labels","__idx":5},"children":["Example Excluding Labels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example demonstrates using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["excluded_label_ids"]}," property. Note that it also includes the other search criteria properties, as these are required."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/manifests HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"carrier_id\": \"se-82785\",\n  \"warehouse_id\": \"se-107273\",\n  \"ship_date\": \"2020-11-06T00:00:00Z\",\n  \"exluded_label_ids\": [\n      \"se-1234\",\n      \"se-1235\",\n      \"se-1236\"\n    ],\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-error-response","__idx":6},"children":["Example Error Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If no labels meet the specified criteria, you will get a response similar to the one below."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"request_id\": \"47b3f327-2dd1-4e24-8570-cda6fba8a00f\",\n    \"errors\": [\n        {\n            \"error_source\": \"shipengine\",\n            \"error_type\": \"system\",\n            \"error_code\": \"unspecified\",\n            \"message\": \"No labels were found matching the given criteria.\"\n        }\n    ]\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Create Manifest","id":"create-manifest","depth":1},{"value":"Create Explicit Manifest","id":"create-explicit-manifest","depth":2},{"value":"Example Request & Response","id":"example-request--response","depth":3},{"value":"Create Implicit Manifests","id":"create-implicit-manifests","depth":2},{"value":"Example Request & Response","id":"example-request--response-1","depth":3},{"value":"Example Excluding Labels","id":"example-excluding-labels","depth":3},{"value":"Example Error Response","id":"example-error-response","depth":3}],"frontmatter":{"seo":{"title":"Create Manifest"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/reference/create-manifest","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}