---
title: "Changes to Create A Batch"
method: POST
path: "/v1/batches"
---

# Changes to Create A Batch

`POST /v1/batches`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 70 revisions.

- **2026-03-26** `b81c65818a89`: 2 breaking
- **2024-10-16** `97d4f65fe53d`: 4 warning, 2 info
- **2024-10-08** `e4ae9b442f54`: 12 info
- **2024-09-13** `5a15ef11fd60`: 28 warning
- **2024-05-01** `46a58a889a57`: 4 info
- **2024-03-21** `9c7925506c11`: 20 warning
- **2024-02-14** `c1c8f9dca5b7`: 1 breaking, 4 warning, 3 info

## Changes

- **2026-03-26** `b81c65818a89`: 2 breaking
  - removed the enum value `label_and_qr_code` of the request property `oneOf[subschema #2: create_and_process_batch_request_body]/process_labels/display_scheme/allOf[subschema #1: display_scheme]/`
  - removed the enum value `qr_code` of the request property `oneOf[subschema #2: create_and_process_batch_request_body]/process_labels/display_scheme/allOf[subschema #1: display_scheme]/`
- **2024-10-16** `97d4f65fe53d`: 4 warning, 2 info
  - added the new `A4` enum value to the `allOf[subschema #1: batch]/label_layout/allOf[subschema #1: label_layout]/` response property for the response status `200`
  - added the new `A4` enum value to the `allOf[subschema #1: batch]/label_layout/allOf[subschema #1: label_layout]/` response property for the response status `207`
  - added the new `A6` enum value to the `allOf[subschema #1: batch]/label_layout/allOf[subschema #1: label_layout]/` response property for the response status `200`
  - added the new `A6` enum value to the `allOf[subschema #1: batch]/label_layout/allOf[subschema #1: label_layout]/` response property for the response status `207`
  - added the new `A4` enum value to the request property `oneOf[subschema #2: create_and_process_batch_request_body]/process_labels/label_layout/allOf[subschema #1: label_layout]/`
  - added the new `A6` enum value to the request property `oneOf[subschema #2: create_and_process_batch_request_body]/process_labels/label_layout/allOf[subschema #1: label_layout]/`
- **2024-10-08** `e4ae9b442f54`: 12 info
  - added the optional property `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/carrier_code` to the response with the `200` status
  - added the optional property `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/carrier_code` to the response with the `207` status
  - added the optional property `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/carrier_id` to the response with the `200` status
  - added the optional property `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/carrier_id` to the response with the `207` status
  - added the optional property `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/field_name` to the response with the `200` status
  - added the optional property `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/field_name` to the response with the `207` status
  - added the optional property `errors/items/allOf[subschema #1: error]/carrier_code` to the response with the `400` status
  - added the optional property `errors/items/allOf[subschema #1: error]/carrier_code` to the response with the `500` status
  - added the optional property `errors/items/allOf[subschema #1: error]/carrier_id` to the response with the `400` status
  - added the optional property `errors/items/allOf[subschema #1: error]/carrier_id` to the response with the `500` status
  - added the optional property `errors/items/allOf[subschema #1: error]/field_name` to the response with the `400` status
  - added the optional property `errors/items/allOf[subschema #1: error]/field_name` to the response with the `500` status
- **2024-09-13** `5a15ef11fd60`: 28 warning
  - added the new `file_not_found` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `file_not_found` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `207`
  - added the new `file_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `file_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - added the new `funding_source_error` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `funding_source_error` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `207`
  - added the new `funding_source_error` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `funding_source_error` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - added the new `funding_source_missing_configuration` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `funding_source_missing_configuration` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `207`
  - added the new `funding_source_missing_configuration` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `funding_source_missing_configuration` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - added the new `funding_source_registration_in_progress` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `funding_source_registration_in_progress` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `207`
  - added the new `funding_source_registration_in_progress` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `funding_source_registration_in_progress` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - added the new `insurance_failure` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `insurance_failure` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `207`
  - added the new `insurance_failure` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `insurance_failure` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - added the new `service_not_determined` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `service_not_determined` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `207`
  - added the new `service_not_determined` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `service_not_determined` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - added the new `shipping_rule_not_found` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `shipping_rule_not_found` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `207`
  - added the new `shipping_rule_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `shipping_rule_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
- **2024-05-01** `46a58a889a57`: 4 info
  - added the new `label_and_paperless` enum value to the request property `oneOf[subschema #2: create_and_process_batch_request_body]/process_labels/display_scheme/allOf[subschema #1: display_scheme]/`
  - added the new `paperless` enum value to the request property `oneOf[subschema #2: create_and_process_batch_request_body]/process_labels/display_scheme/allOf[subschema #1: display_scheme]/`
  - added the required property `allOf[subschema #1: batch]/paperless_download` to the response with the `200` status
  - added the required property `allOf[subschema #1: batch]/paperless_download` to the response with the `207` status
- **2024-03-21** `9c7925506c11`: 20 warning
  - added the new `customs_items_required` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `customs_items_required` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `207`
  - added the new `customs_items_required` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `customs_items_required` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - added the new `incompatible_paired_labels` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `incompatible_paired_labels` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `207`
  - added the new `incompatible_paired_labels` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `incompatible_paired_labels` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - added the new `invalid_charge_event` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `invalid_charge_event` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `207`
  - added the new `invalid_charge_event` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `invalid_charge_event` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - added the new `invalid_object` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `invalid_object` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `207`
  - added the new `invalid_object` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `invalid_object` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - added the new `no_rates_returned` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `no_rates_returned` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `207`
  - added the new `no_rates_returned` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `no_rates_returned` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
- **2024-02-14** `c1c8f9dca5b7`: 1 breaking, 4 warning, 3 info
  - the request's body type changed from `object` to no type
  - removed the request property `batch_notes`
  - removed the request property `external_batch_id`
  - removed the request property `rate_ids`
  - removed the request property `shipment_ids`
  - added `#/components/schemas/create_batch_request_body, #/components/schemas/create_and_process_batch_request_body` to the request body `oneOf` list
  - added the required property `allOf[subschema #1: batch]/process_errors` to the response with the `200` status
  - added the success response with the status `207`

---

[Operation](https://skmtc.dev/shipengine/apis/shipengine-api/docs/v1/batches/post.md) - [API](https://skmtc.dev/shipengine/apis/shipengine-api.md) - [Page](https://skmtc.dev/shipengine/apis/shipengine-api/changes/v1/batches/post)