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

# POST /projects

`POST /projects`

Creates an empty project with a placement template. A project contains zero or more placements that adhere to the placement template defined in the project.

## Request body

- object
  - `projectName` string, required — The name of the project to create.
  - `description` string — An optional description for the project.
  - `placementTemplate` object — An object defining the template for a placement.
    - `defaultAttributes` object — The default attributes (key/value pairs) to be applied to all placements using this template.
    - `deviceTemplates` object — An object specifying the <a>DeviceTemplate</a> for all placements using this (<a>PlacementTemplate</a>) template.
  - `tags` object — Optional tags (metadata key/value pairs) to be associated with the project. For example, <code>{ {"key1": "value1", "key2": "value2"} }</code>. For more information, see <a href="https://aws.amazon.com/answers/account-management/aws-tagging-strategies/">AWS Tagging Strategies</a>.

## Response `200`

Success

- CreateProjectResponse

## Other responses

- `480` — InternalFailureException
- `481` — InvalidRequestException
- `482` — ResourceConflictException

---

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