---
title: "Create Item"
method: POST
path: "/items.json"
tags: ["Items"]
---

# Create Item

`POST /items.json`

Creates a new item.

## Query parameters

- `api_key` string, required

## Request body

- ItemRequest
  - `item` object, required
    - `name` string, required — Item name. Values longer than 60 characters are rejected with HTTP 422 — they are not truncated.
    - `description` string, required — Item description. Values longer than 200 characters are rejected with HTTP 422 — they are not truncated.
    - `unit_price` number, required
    - `unit` string — One of: `hour`, `day`, `month`, `unit`, `service`, `tax`, `other`, `product`, `article`.
    - `tax` object
      - `name` string

## Response `201`

SUCCESS. Returns the created item.

- ItemsGetResponse
  - `item` object
    - `id` integer
    - `name` string
    - `description` string, nullable
    - `unit_price` string
    - `unit` string — One of: `hour`, `day`, `month`, `unit`, `service`, `tax`, `other`, `product`, `article`.
    - `tax` object
      - `name` string
      - `value` string
      - `comment` string

## Other responses

- `401` — ACCESS DENIED
- `422` — UNPROCESSABLE ENTITY

## Changes

- **2026-08-25** `5b82d4eb0d9f` — 4 breaking, 3 warning
  - the response property `item/description` became nullable for the status `201`
  - the `errors` response's property type/format changed from `object`/`` to `array`/`` for status `401`
  - the `item/tax/value` response's property type/format changed from `number`/`` to `string`/`` for status `201`
  - the `item/unit_price` response's property type/format changed from `number`/`` to `string`/`` for status `201`
  - …3 more

[Change history](https://skmtc.dev/invoicexpress/apis/invoicexpress-api/changes/items.json/post.md)

---

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