# Create Product

Add a new product.

Endpoint: POST /organisations/{orgId}/products
Version: v2_28
Security: ApiKeyAuth

## Path parameters:

  - `orgId` (string, required)
    The organisation identity

## Header parameters:

  - `contentType` (string, required)

## Request fields (application/json):

  - `name` (string, required)
    The name for the product.

  - `hsCode` (string)
    This is the HS (Harmonised Standard) code for the product. This is optional unless this product will be part of submission to the Traces NT system.

  - `description` (string)
    This is a simple description for the product. This is optional unless this product will be part of submission to the Traces NT system.

  - `allowedMaterials` (array, required)
    The URI(s) of the material(s) that are allowed to be used for this product.

  - `baseUnit` (string, required)
    The URI to the base unit of measurement that this product is specified in.

  - `defaultUnit` (string)
    The URI to the unit of measurement that you wish to use as the default unit of measurement.

  - `additionalUnits` (array, required)
    A list of additional units that specify the factor for converting from the base unit to other base units: e.g. unit to kg

  - `additionalUnits.baseUnit` (string, required)
    The URI to the base unit of measurement to convert the base qty to. So if the product is specified in units and the conversion specifies kg then this conversion will provide the per unit mass.

  - `additionalUnits.conversionFactor` (number, required)
    The conversion factor from product base unit to conversion base unit.

  - `id` (string)
    System assigned or user defined id field.

## Response 201 fields (application/json):

  - `name` (string, required)
    The name for the product.

  - `hsCode` (string)
    This is the HS (Harmonised Standard) code for the product. This is optional unless this product will be part of submission to the Traces NT system.

  - `description` (string)
    This is a simple description for the product. This is optional unless this product will be part of submission to the Traces NT system.

  - `allowedMaterials` (array, required)
    The URI(s) of the material(s) that are allowed to be used for this product.

  - `baseUnit` (string, required)
    The URI to the base unit of measurement that this product is specified in.

  - `defaultUnit` (string)
    The URI to the unit of measurement that you wish to use as the default unit of measurement.

  - `additionalUnits` (array, required)
    A list of additional units that specify the factor for converting from the base unit to other base units: e.g. unit to kg

  - `additionalUnits.baseUnit` (string, required)
    The URI to the base unit of measurement to convert the base qty to. So if the product is specified in units and the conversion specifies kg then this conversion will provide the per unit mass.

  - `additionalUnits.conversionFactor` (number, required)
    The conversion factor from product base unit to conversion base unit.

  - `recordState` (string)
    State of the record.
    Enum: "ACTIVE", "ARCHIVED"

  - `id` (string)
    System assigned or user defined id field.

  - `createdBy` (string)
    User who created the record.

  - `createdTime` (string)
    Date & Time that the record was created.

  - `updatedBy` (string)
    Last updated by user.

  - `updatedTime` (string)
    Date & Time that the record was last updated.


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 429 fields

## Response 500 fields