---
title: "Creates a new product"
method: POST
path: "/api/v1/products"
tags: ["Products"]
---

# Creates a new product

`POST /api/v1/products`

## Request body

- BillbeeInterfacesBillbeeAPIModelArticleApiModel
  - `InvoiceText` BillbeeIntegrationChannelModelApiMultiLanguageString[]
    - `Text` string
    - `LanguageCode` string
  - `Manufacturer` string
  - `Id` integer
  - `Title` BillbeeIntegrationChannelModelApiMultiLanguageString[]
    - `Text` string
    - `LanguageCode` string
  - `Description` BillbeeIntegrationChannelModelApiMultiLanguageString[]
    - `Text` string
    - `LanguageCode` string
  - `ShortDescription` BillbeeIntegrationChannelModelApiMultiLanguageString[]
    - `Text` string
    - `LanguageCode` string
  - `BasicAttributes` BillbeeIntegrationChannelModelApiMultiLanguageString[]
    - `Text` string
    - `LanguageCode` string
  - `Images` BillbeeInterfacesBillbeeAPIModelArticleImageRelationApiModel[]
    - `Url` string
    - `Id` integer
    - `ThumbPathExt` string
    - `ThumbUrl` string
    - `Position` integer
    - `IsDefault` boolean
    - `ArticleId` integer
  - `VatIndex` integer, required
  - `Price` number, double, required
  - `CostPrice` number, double
  - `Vat1Rate` number, double, required
  - `Vat2Rate` number, double, required
  - `StockDesired` number, double
  - `StockCurrent` number, double
  - `StockWarning` number, double
  - `SKU` string
  - `EAN` string
  - `Materials` BillbeeIntegrationChannelModelApiMultiLanguageString[]
    - `Text` string
    - `LanguageCode` string
  - `Tags` BillbeeIntegrationChannelModelApiMultiLanguageString[]
    - `Text` string
    - `LanguageCode` string
  - `Sources` BillbeeInterfacesBillbeeAPIModelArticleSourceApiModel[]
    - `Id` integer
    - `Source` string, required
    - `SourceId` string, required
    - `ApiAccountName` string
    - `ApiAccountId` integer
    - `ExportFactor` number, double
    - `StockSyncInactive` boolean
    - `StockSyncMin` number, double
    - `StockSyncMax` number, double
    - `UnitsPerItem` number, double
    - `Custom` object
  - `Weight` integer
  - `WeightNet` integer
  - `LowStock` boolean
  - `StockCode` string
  - `StockReduceItemsPerSale` number, double
  - `Stocks` BillbeeInterfacesBillbeeAPIModelStockArticleApiModel[]
    - `Name` string
    - `StockId` integer
    - `StockCurrent` number, double
    - `StockCurrentIsCalculated` boolean
    - `StockWarning` number, double
    - `StockCode` string
    - `UnfulfilledAmount` number, double
    - `StockDesired` number, double
  - `Category1` BillbeeInterfacesBillbeeAPIModelArticleCategoryApiModel
    - `Name` string
    - `Id` integer
  - `Category2` BillbeeInterfacesBillbeeAPIModelArticleCategoryApiModel
    - `Name` string
    - `Id` integer
  - `Category3` BillbeeInterfacesBillbeeAPIModelArticleCategoryApiModel
    - `Name` string
    - `Id` integer
  - `Type` integer, required
  - `Unit` integer
  - `UnitsPerItem` number, double
  - `SoldAmount` number, double
  - `SoldSumGross` number, double
  - `SoldSumNet` number, double
  - `SoldSumNetLast30Days` number, double
  - `SoldSumGrossLast30Days` number, double
  - `SoldAmountLast30Days` number, double
  - `ShippingProductId` integer
  - `IsDigital` boolean, required
  - `IsCustomizable` boolean, required
  - `DeliveryTime` integer
  - `Recipient` integer
  - `Occasion` integer
  - `CountryOfOrigin` string
  - `ExportDescription` string
  - `ExportDescriptionMultiLanguage` BillbeeIntegrationChannelModelApiMultiLanguageString[]
    - `Text` string
    - `LanguageCode` string
  - `TaricNumber` string
  - `HtsusCode` string
  - `Condition` integer
  - `WidthCm` number, double
  - `LengthCm` number, double
  - `HeightCm` number, double
  - `BillOfMaterial` BillbeeInterfacesBillbeeAPIModelBomSubArticleApiModel[]
    - `Amount` number, double
    - `ArticleId` integer
    - `SKU` string
  - `CustomFields` BillbeeInterfacesBillbeeAPIModelArticleApiCustomFieldValueModel[]
    - `Id` integer
    - `DefinitionId` integer
    - `Definition` BillbeeInterfacesBillbeeAPIModelArticleApiCustomFieldDefinitionModel
      - `Id` integer
      - `Name` string
      - `Configuration` object
      - `Type` 0 | 1 | 2 | 3
      - `IsNullable` boolean
    - `ArticleId` integer
    - `Value` object
  - `IsDeactivated` boolean
  - `Net` number, double
  - `CostPriceNet` number, double

## Response `200`

OK

- object

---

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