---
title: "Create a product"
method: POST
path: "/consumers/{consumer_id}/invoicing/products"
tags: ["Invoicing", "Products"]
---

# Create a product

`POST /consumers/{consumer_id}/invoicing/products`

Create a new product.

## Path parameters

- `consumer_id` string, uuid, required

## Request body

- ProductItem
  - `name` string, required — Name
  - `unit_price` number, nullable — Unit price
  - `tax_id` string, nullable — Technical id of the tax in Chift
  - `code` string, nullable — Reference/code
  - `unit` string, nullable — Unit of measure matching target software name
  - `category` string, nullable — Category matching target software name
  - `currency` string, nullable — Currency matching target software name
  - `description` string, nullable — Description
  - `cost` number, nullable — Cost of the product

## Response `200`

Successful Response

- ProductItemOut
  - `id` string, required — Technical id in Chift
  - `source_ref` Ref, required
    - `id` string, nullable — Technical id in the target software
    - `model` string, nullable — Name of the model/entity in the target software
  - `name` string, required — Name
  - `unit_price` number, nullable — Unit price
  - `tax_id` string, nullable — Technical id of the tax in Chift
  - `code` string, nullable — Reference/code
  - `unit` string, nullable — Unit of measure matching target software name
  - `category` string, nullable — Category matching target software name
  - `currency` string, nullable — Currency matching target software name
  - `description` string, nullable — Description
  - `cost` number, nullable — Cost of the product
  - `available_quantity` number, nullable — Available quanity of the product in stock. Will only be used for products that have an inventory (services will always be 0)

## Other responses

- `400` — Bad Request
- `422` — Validation Error

---

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