---
title: "Create a product"
method: POST
path: "/apps/{appId}/products"
tags: ["Products"]
---

# Create a product

`POST /apps/{appId}/products`

Create a new product

## Path parameters

- `appId` integer, required

## Query parameters

- `name` string, required
- `amount` integer
- `amount_accurately` integer
- `vat_percent` integer
- `image` union
  - string, binary
  - string, uri
- `lifetime` integer
- `description` string
- `type` 'product' | 'service'
- `quantity_name` string
- `reference` string
- `account_id` string
- `tags` unknown[]
  - unknown
- `category_id` integer
- `metadata` string[], nullable

## Response `200`

Success

- Product
  - `id` integer
  - `name` string
  - `amount_accurately` integer — Price without taxes in milli-cents
  - `vat_percent` integer — VAT rate in cents
  - `currency` string
  - `image` union
    - string, binary
    - string, uri
  - `lifetime` integer — Product life time in seconds
  - `description` string
  - `unity` string — Unity, hours, days, meters, liters..
  - `intangible` boolean — Is a service or a product ?
  - `quantity_name` string — Name of the quantity: days, liters, m2, m3...
  - `reference` string
  - `accounting_number` string
  - `tags` string[]
  - `category` ProductCategory
    - `id` integer
    - `name` string
    - `image` union
      - string, binary
      - string, uri
    - `parent` ProductCategory — recursive
    - `products` Product — recursive
  - `metadata` unknown[], nullable
    - unknown

## Other responses

- `404` — Not found

---

[API](https://skmtc.net/sinao/apis/sinao-api.md) · [All operations](https://skmtc.net/sinao/apis/sinao-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinao/sinao-api/versions/436b47b78bf4/schema)