--- title: "Create totes in batch" method: POST path: "/v2/totes" tags: ["totes"] --- # Create totes in batch `POST /v2/totes` Create multiple totes at once. Returns both successfully created totes and any failures. ## Request body - ToteCreateBatchRequest — Request to create multiple totes in batch - `totes` ToteCreateRequest[], required — Array of totes to create - `inventory_warehouse_id` string, required — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `tote_name` string, required — Name for the new tote - `tote_barcode` string — Barcode identifier for the tote (optional) - `return_succeeded_totes` boolean — Whether to include successfully created totes in the response. When false, only failed_totes will be returned. ## Response `200` Batch creation response with succeeded and failed totes - BulkCreateToteResponse — Response for batch tote creation - `succeeded_totes` Tote[] — Totes that were successfully created - `tote_id` string, required — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `inventory_warehouse_id` string, required — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `tote_name` string, required — Name of the tote - `tote_barcode` string — Barcode identifier for the tote - `created_at` string, date-time, required — Date and time when the tote was created - `failed_totes` FailedToteResponse[] — Totes that failed to be created - `inventory_warehouse_id` string — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `tote_name` string — The tote name from the failed request - `tote_barcode` string — The tote barcode from the failed request - `error_message` string — Error message explaining why creation failed ## 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)