--- title: "Create manifest" method: POST path: "/v2/manifests" tags: ["manifests"] --- # Create manifest `POST /v2/manifests` Each ShipStation manifest is created for a specific warehouse, so you'll need to provide the warehouse_id rather than the ship_from address. You can create a warehouse for each location that you want to create manifests for. ## Request body - union - CreateManifestByObjectRequestBody — A create manifest request body - `carrier_id` string, required — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `excluded_label_ids` SeId[] — The list of label ids to exclude from the manifest - `label_ids` SeId[] — The list of label ids to include for the manifest - `warehouse_id` string, required — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `ship_date` string, date-time, required — The ship date that the shipment will be sent out on - CreateManifestLabelIdsRequestBody — A create manifest request body - `label_ids` SeId[], required — The list of label ids to include in the manifest ## Response `200` The request was a success. - CreateManifestResponseBody — An error response body - `manifests` Manifest[] — Resulting Manifests - `manifest_id` string — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `form_id` string — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `created_at` string, date-time — The date-time that the manifest was created - `ship_date` string, date-time — The date-time that the manifests shipments will be picked up - `shipments` integer — The number of shipments that are included in this manifest - `label_ids` SeId[] — An array of the label ids used in this manifest. - `warehouse_id` string — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `submission_id` string — A string that uniquely identifies the submission - `carrier_id` string — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `manifest_download` ManifestDownload — Object containing the href link to download the manifest file - `href` string, url — A URL - `manifest_request_id` string — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `status` 'in_progress' | 'completed' — The possible statuses of a manifest request - `manifest_id` string, required — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `form_id` string, required — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `created_at` string, date-time, required — The date-time that the manifest was created - `ship_date` string, date-time, required — The date-time that the manifests shipments will be picked up - `shipments` integer, required — The number of shipments that are included in this manifest - `warehouse_id` string, required — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `submission_id` string, required — A string that uniquely identifies the submission - `carrier_id` string, required — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `manifest_download` ManifestDownload, required — Object containing the href link to download the manifest file - `href` string, url — A URL - `label_ids` SeId[] — An array of the label ids used in this manifest. - `request_id` string, uuid, required — A UUID (a.k.a. GUID) that uniquely identifies a resource - `errors` ErrorWithLabelId[], required — The errors associated with the failed API call - `error_source` 'carrier' | 'order_source' | 'ShipStation' | 'shipengine', required — The source of the error, as indicated by the name this informs us if the API call failed because of the carrier, the order source, the ShipStation API itself, or the underlying ShipEngine platform. - `error_type` 'account_status' | 'business_rules' | 'validation' | 'security' | 'system' | 'integrations', required — The type of error - `error_code` 'auto_fund_not_supported' | 'batch_cannot_be_modified' | 'carrier_conflict' | 'carrier_disconnected' | 'carrier_not_connected' | 'carrier_not_supported' | 'confirmation_not_supported' | 'default_warehouse_cannot_be_deleted' | 'field_conflict' | 'field_value_required' | 'forbidden' | 'identifier_conflict' | 'identifiers_must_match' | 'insufficient_funds' | 'invalid_address' | 'invalid_billing_plan' | 'invalid_field_value' | 'invalid_identifier' | 'invalid_status' | 'invalid_string_length' | 'label_images_not_supported' | 'meter_failure' | 'order_source_not_active' | 'rate_limit_exceeded' | 'refresh_not_supported' | 'request_body_required' | 'return_label_not_supported' | 'settings_not_supported' | 'subscription_inactive' | 'terms_not_accepted' | 'tracking_not_supported' | 'trial_expired' | 'unauthorized' | 'unknown' | 'unspecified' | 'verification_failure' | 'warehouse_conflict' | 'webhook_event_type_conflict' | 'customs_items_required' | 'incompatible_paired_labels' | 'invalid_charge_event' | 'invalid_object' | 'no_rates_returned' | 'freight_connection_inactive' | 'freight_provider_id_required' | 'freight_shipment_not_found' | 'freight_tracking_not_available' | 'freight_tracking_not_found' | 'freight_shipment_not_batchable', required — The error code specified for the failed API Call - `message` string, required — An error message associated with the failed API call - `label_id` string — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. ## Other responses - `400` — The request contained errors. - `500` — The request was successful. --- [API](https://skmtc.net/shipstation/apis/shipstation-api-v2.md) · [All operations](https://skmtc.net/shipstation/apis/shipstation-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipstation/shipstation-api-v2/revisions/d3d8c21cd227/schema)