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

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

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

Creates a state template. State templates contain state properties, which are signals that belong to a signal catalog that is synchronized between the Amazon Web Services IoT FleetWise Edge and the Amazon Web Services Cloud.

Access to certain Amazon Web Services IoT FleetWise features is currently gated. For more information, see [Amazon Web Services Region and feature availability](https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/fleetwise-regions.html) in the _Amazon Web Services IoT FleetWise Developer Guide_.

## Headers

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

## Request body

- CreateStateTemplateRequest
  - `name` string, required — The name of the state template.
  - `description` string — A brief description of the state template.
  - `signalCatalogArn` string, required — The ARN of the signal catalog associated with the state template.
  - `stateTemplateProperties` NodePath[], required — A list of signals from which data is collected. The state template properties contain the fully qualified names of the signals.
  - `dataExtraDimensions` NodePath[] — A list of vehicle attributes to associate with the payload published on the state template's MQTT topic. (See <a href="https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/process-visualize-data.html#process-last-known-state-vehicle-data"> Processing last known state vehicle data using MQTT messaging</a>). For example, if you add <code>Vehicle.Attributes.Make</code> and <code>Vehicle.Attributes.Model</code> attributes, Amazon Web Services IoT FleetWise will enrich the protobuf encoded payload with those attributes in the <code>extraDimensions</code> field.
  - `metadataExtraDimensions` NodePath[] — <p>A list of vehicle attributes to associate with user properties of the messages published on the state template's MQTT topic. (See <a href="https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/process-visualize-data.html#process-last-known-state-vehicle-data"> Processing last known state vehicle data using MQTT messaging</a>). For example, if you add <code>Vehicle.Attributes.Make</code> and <code>Vehicle.Attributes.Model</code> attributes, Amazon Web Services IoT FleetWise will include these attributes as User Properties with the MQTT message.</p> <p>Default: An empty array</p>
  - `tags` Tag[] — Metadata that can be used to manage the state template.
    - `Key` string, required — The tag's key.
    - `Value` string, required — The tag's value.

## Response `200`

Success

- CreateStateTemplateResponse
  - `name` string — The name of the state template.
  - `arn` string — The Amazon Resource Name (ARN) of the state template.
  - `id` string — The unique ID of the state template.

## Other responses

- `480` — ResourceNotFoundException
- `481` — InternalServerException
- `482` — ConflictException
- `483` — LimitExceededException
- `484` — ThrottlingException
- `485` — ValidationException
- `486` — InvalidSignalsException
- `487` — 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/revisions/0f1f9edeb409/schema)