---
title: "POST /dynamic-thing-groups/{thingGroupName}"
method: POST
path: "/dynamic-thing-groups/{thingGroupName}"
---

# POST /dynamic-thing-groups/{thingGroupName}

`POST /dynamic-thing-groups/{thingGroupName}`

Creates a dynamic thing group.

Requires permission to access the [CreateDynamicThingGroup](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

## Path parameters

- `thingGroupName` string, required

## Request body

- object
  - `thingGroupProperties` object — Thing group properties.
    - `thingGroupDescription` string — The thing group description.
    - `attributePayload` object — The thing group attributes in JSON format.
      - `attributes` object — <p>A JSON string containing up to three key-value pair in JSON format. For example:</p> <p> <code>{\"attributes\":{\"string1\":\"string2\"}}</code> </p>
      - `merge` boolean — <p>Specifies whether the list of attributes provided in the <code>AttributePayload</code> is merged with the attributes stored in the registry, instead of overwriting them.</p> <p>To remove an attribute, call <code>UpdateThing</code> with an empty attribute value.</p> <note> <p>The <code>merge</code> attribute is only valid when calling <code>UpdateThing</code> or <code>UpdateThingGroup</code>.</p> </note>
  - `indexName` string — <p>The dynamic thing group index name.</p> <note> <p>Currently one index is supported: <code>AWS_Things</code>.</p> </note>
  - `queryString` string, required — <p>The dynamic thing group search query string.</p> <p>See <a href="https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html">Query Syntax</a> for information about query string syntax.</p>
  - `queryVersion` string — <p>The dynamic thing group query version.</p> <note> <p>Currently one query version is supported: "2017-09-30". If not specified, the query version defaults to this value.</p> </note>
  - `tags` Tag[] — Metadata which can be used to manage the dynamic thing group.
    - `Key` string, required — The tag's key.
    - `Value` string — The tag's value.

## Response `200`

Success

- CreateDynamicThingGroupResponse
  - `thingGroupName` string — The dynamic thing group name.
  - `thingGroupArn` string — The dynamic thing group ARN.
  - `thingGroupId` string — The dynamic thing group ID.
  - `indexName` string — The dynamic thing group index name.
  - `queryString` string — The dynamic thing group search query string.
  - `queryVersion` string — The dynamic thing group query version.

## Other responses

- `480` — InvalidRequestException
- `481` — ResourceAlreadyExistsException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException
- `484` — InternalFailureException
- `485` — InvalidQueryException
- `486` — LimitExceededException

---

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