---
title: "POST /thing-registration-tasks"
method: POST
path: "/thing-registration-tasks"
---

# POST /thing-registration-tasks

`POST /thing-registration-tasks`

Creates a bulk thing provisioning task.

Requires permission to access the [StartThingRegistrationTask](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.
  - `inputFileBucket` string, required — The S3 bucket that contains the input file.
  - `inputFileKey` string, required — The name of input file within the S3 bucket. This file contains a newline delimited JSON file. Each line contains the parameter values to provision one device (thing).
  - `roleArn` string, required — The IAM role ARN that grants permission the input file.

## Response `200`

Success

- StartThingRegistrationTaskResponse
  - `taskId` string — The bulk thing provisioning task ID.

## Other responses

- `480` — InvalidRequestException
- `481` — ThrottlingException
- `482` — UnauthorizedException
- `483` — InternalFailureException

---

[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)