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

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

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

Creates a vehicle, which is an instance of a vehicle model (model manifest). Vehicles created from the same vehicle model consist of the same signals inherited from the vehicle model.

If you have an existing Amazon Web Services IoT thing, you can use Amazon Web Services IoT FleetWise to create a vehicle and collect data from your thing.

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

## Headers

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

## Request body

- CreateVehicleRequest
  - `vehicleName` string, required — The unique ID of the vehicle to create.
  - `modelManifestArn` string, required — The Amazon Resource Name ARN of a vehicle model.
  - `decoderManifestArn` string, required — The ARN of a decoder manifest.
  - `attributes` object — <p>Static information about a vehicle in a key-value pair. For example: <code>"engineType"</code> : <code>"1.3 L R2"</code> </p> <p>To use attributes with Campaigns or State Templates, you must include them using the request parameters <code>dataExtraDimensions</code> and/or <code>metadataExtraDimensions</code> (for state templates only) when creating your campaign/state template. </p>
  - `associationBehavior` 'CreateIotThing' | 'ValidateIotThingExists' — <p> An option to create a new Amazon Web Services IoT thing when creating a vehicle, or to validate an existing Amazon Web Services IoT thing as a vehicle. </p> <p>Default: <code/> </p>
  - `tags` Tag[] — Metadata that 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 with the vehicle. You can monitor the last known state of the vehicle in near real time.
    - `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

- CreateVehicleResponse
  - `vehicleName` string — The unique ID of the created vehicle.
  - `arn` string — The ARN of the created vehicle.
  - `thingArn` string — The ARN of a created or validated Amazon Web Services IoT thing.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — ConflictException
- `483` — LimitExceededException
- `484` — ThrottlingException
- `485` — ValidationException
- `486` — 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)