---
title: "Creates a new item"
method: POST
path: "/items"
---

# Creates a new item

`POST /items`

## Request body

- Item
  - `id` string
  - `name` string
  - `price` string
  - `color` string

## Response `201`

Success

- Message
  - `message` string

## Other responses

- `400` — The request was invalid or cannot be otherwise served.
- `401` — Authentication credentials were missing or incorrect.
- `403` — The request is understood, but it has been refused or access is not allowed.
- `404` — The URI requested is invalid or the resource requested does not exists.
- `409` — Any message which should help the user to resolve the conflict.
- `429` — The request cannot be served due to the application’s rate limit having been exhausted for the resource.
- `500` — Something is broken.
- `503` — The server is up, but overloaded with requests. Try again later.

---

[API](https://skmtc.dev/firewalla/apis/firewalla-api.md) · [All operations](https://skmtc.dev/firewalla/apis/firewalla-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/firewalla/firewalla-api/revisions/8ddb0f8ea886/schema)