---
title: "POST /things"
method: POST
path: "/things"
---

# POST /things

`POST /things`

Provisions a thing in the device registry. RegisterThing calls other IoT control plane APIs. These calls might exceed your account level [IoT Throttling Limits](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_iot) and cause throttle errors. Please contact [Amazon Web Services Customer Support](https://console.aws.amazon.com/support/home) to raise your throttling limits if necessary.

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

## Request body

- object
  - `templateBody` string, required — The provisioning template. See <a href="https://docs.aws.amazon.com/iot/latest/developerguide/provision-w-cert.html">Provisioning Devices That Have Device Certificates</a> for more information.
  - `parameters` object — The parameters for provisioning a thing. See <a href="https://docs.aws.amazon.com/iot/latest/developerguide/provision-template.html">Provisioning Templates</a> for more information.

## Response `200`

Success

- RegisterThingResponse
  - `certificatePem` string — The certificate data, in PEM format.
  - `resourceArns` object — ARNs for the generated resources.

## Other responses

- `480` — InternalFailureException
- `481` — ServiceUnavailableException
- `482` — InvalidRequestException
- `483` — UnauthorizedException
- `484` — ThrottlingException
- `485` — ConflictingResourceUpdateException
- `486` — ResourceRegistrationFailureException

---

[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/revisions/deef5c4b09f0/schema)