---
title: "POST /#X-Amz-Target=IoTAutobahnControlPlane.BatchCreateVehicle"
method: POST
path: "/#X-Amz-Target=IoTAutobahnControlPlane.BatchCreateVehicle"
---

# POST /#X-Amz-Target=IoTAutobahnControlPlane.BatchCreateVehicle

`POST /#X-Amz-Target=IoTAutobahnControlPlane.BatchCreateVehicle`

Creates a group, or batch, of vehicles.

You must specify a decoder manifest and a vehicle model (model manifest) for each vehicle.

For more information, see [Create multiple vehicles (AWS CLI)](https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/create-vehicles-cli.html) in the _Amazon Web Services IoT FleetWise Developer Guide_.

## Headers

- `X-Amz-Target` 'IoTAutobahnControlPlane.BatchCreateVehicle', required

## Request body

- BatchCreateVehicleRequest
  - `vehicles` CreateVehicleRequestItem[], required — A list of information about each vehicle to create. For more information, see the API data type.
    - `vehicleName` string, required — The unique ID of the vehicle to create.
    - `modelManifestArn` string, required — The ARN of the vehicle model (model manifest) to create the vehicle from.
    - `decoderManifestArn` string, required — The Amazon Resource Name (ARN) of a decoder manifest associated with the vehicle to create.
    - `attributes` object — Static information about a vehicle in a key-value pair. For example: <code>"engine Type"</code> : <code>"v6"</code>
    - `associationBehavior` 'CreateIotThing' | 'ValidateIotThingExists' — An option to create a new Amazon Web Services IoT thing when creating a vehicle, or to validate an existing thing as a vehicle.
    - `tags` Tag[] — Metadata which can be used to manage the vehicle.
      - `Key` string, required — The tag's key.
      - `Value` string, required — The tag's value.
    - `stateTemplates` StateTemplateAssociation[] — Associate state templates to track the state of the vehicle. State templates determine which signal updates the vehicle sends to the cloud.
      - `identifier` string, required — The unique ID of the state template.
      - `stateTemplateUpdateStrategy` StateTemplateUpdateStrategy, required — <p>The update strategy for the state template. Vehicles associated with the state template can stream telemetry data with either an <code>onChange</code> or <code>periodic</code> update strategy. </p> <important> <p>Access to certain Amazon Web Services IoT FleetWise features is currently gated. For more information, see <a href="https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/fleetwise-regions.html">Amazon Web Services Region and feature availability</a> in the <i>Amazon Web Services IoT FleetWise Developer Guide</i>.</p> </important>
        - `periodic` PeriodicStateTemplateUpdateStrategy — Vehicles associated with the state template will stream telemetry data during a specified time period.
          - `stateTemplateUpdateRate` TimePeriod, required — The length of time between state template updates.
            - `unit` 'MILLISECOND' | 'SECOND' | 'MINUTE' | 'HOUR', required — A unit of time.
            - `value` integer, required — A number of time units.
        - `onChange` OnChangeStateTemplateUpdateStrategy — Vehicles associated with the state template will stream telemetry data when there is a change.

## Response `200`

Success

- BatchCreateVehicleResponse
  - `vehicles` CreateVehicleResponseItem[] — A list of information about a batch of created vehicles. For more information, see the API data type.
    - `vehicleName` string — The unique ID of the vehicle to create.
    - `arn` string — The ARN of the created vehicle.
    - `thingArn` string — The ARN of a created or validated Amazon Web Services IoT thing.
  - `errors` CreateVehicleError[] — A list of information about creation errors, or an empty list if there aren't any errors.
    - `vehicleName` string — The ID of the vehicle with the error.
    - `code` string — An HTTP error code.
    - `message` string — A description of the HTTP error.

## Other responses

- `480` — InternalServerException
- `481` — LimitExceededException
- `482` — ThrottlingException
- `483` — ValidationException
- `484` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/iotfleetwise.md) · [All operations](https://skmtc.net/aws/apis/iotfleetwise/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iotfleetwise/versions/0f1f9edeb409/schema)