> ## Documentation Index > Fetch the complete documentation index at: https://apidocs.noyax.com/llms.txt > Use this file to discover all available pages before exploring further. # Create product > Creates a product and its sub-records in one transaction. The product and all sub-records are written in **a single transaction**: if any record is invalid, nothing is saved and all errors are returned in one `Message`. Required fields, type lists and group rules. Price/discount rules and scope. * `Code`, `Name` and `UnitId` are required; all other fields are optional. * Send `"Next"` as `Code` to generate the code from the **ÜRÜN** serial number definition. * `Parameters` and `CriticalStock` use the same rules as their own [parameter](/en/v1/products/parameters/create) and [critical stock](/en/v1/products/critical-stock/create) records. In `Prices`, `UnitId` can only be the product's own `UnitId`, since the product has no second/third unit yet on create. * Send an empty array (`[]`) for sub-record lists you do not need. A successful response returns **201 Created** and the `Location` header points to the new product. ## OpenAPI ````yaml api-reference/openapi.json POST /api/v1/products openapi: 3.1.1 info: title: Noyax API description: Server-to-server API for integrations to access Noyax data. version: '1.0' servers: - url: https://api.noyax.com security: - Bearer: [] tags: - name: Sections - name: Warehouses - name: Product Critical Stock - name: Product groups - name: Product Parameter Definitions - name: Product Parameters - name: Product Prices - name: Products - name: Cities - name: Countries - name: Currencies - name: Districts - name: Shipment Definitions - name: Units - name: VAT rates - name: Customer Addresses - name: Customer Bank Accounts - name: Customer Definitions - name: Customer Group Members - name: Customer Links - name: Customer Parameters - name: Customer Representatives - name: Customers - name: Customer Statement - name: Customer Telephones paths: /api/v1/products: post: tags: - Products summary: Create product description: >- Creates a product and its sub-records (parameters, prices, critical stock) in one transaction. Code, Name and UnitId are required. Send Code as "Next" to generate the code from the "ÜRÜN" serial number definition. parameters: - name: X-UserID in: header description: >- ID of the Noyax user the request is made on behalf of. Written to the audit fields of created, updated and deleted records. required: true schema: minimum: 1 type: integer format: int32 - name: X-CompanyID in: header description: >- ID of the company. The user must be assigned to this company. All reads and writes are limited to this company. required: true schema: minimum: 1 type: integer format: int32 - name: X-PeriodID in: header description: >- ID of the accounting period. Optional for customer endpoints; if sent, it is written to created records. schema: minimum: 1 type: integer format: int32 requestBody: content: application/json: schema: $ref: '#/components/schemas/ProductCreateRequestDto' text/json: schema: $ref: '#/components/schemas/ProductCreateRequestDto' application/*+json: schema: $ref: '#/components/schemas/ProductCreateRequestDto' required: true responses: '201': description: Created content: application/json: schema: $ref: '#/components/schemas/DataResultOfProductDetailDto' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorResult' example: Success: false ResultCode: '2005' Message: UnitId is required. Errors: - Code: '2005' Message: UnitId is required. '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResult' example: Success: false ResultCode: '0102' Message: Token has expired. Obtain a new token using the refresh token. Errors: - Code: '0102' Message: >- Token has expired. Obtain a new token using the refresh token. '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResult' example: Success: false ResultCode: '0110' Message: You do not have permission for this operation. Errors: - Code: '0110' Message: You do not have permission for this operation. '429': description: Too Many Requests content: application/json: schema: $ref: '#/components/schemas/ErrorResult' example: Success: false ResultCode: '0120' Message: Daily request limit (10000) exceeded. Errors: - Code: '0120' Message: Daily request limit (10000) exceeded. components: schemas: ProductCreateRequestDto: type: object properties: Code: type: - 'null' - string description: >- Required. Product code, unique within the company. Send "Next" to generate it from the "ÜRÜN" serial number definition (create only). At most 50 characters. example: URN-0001 Name: type: - 'null' - string description: Required. Product name. At most 255 characters. example: VİDA 5X40 GALVANİZ UnitId: type: - 'null' - string description: Required. ID of the main unit from GET /api/v1/definitions/units. format: uuid Barcode: type: - 'null' - string description: Barcode of the main unit. At most 30 characters. example: '8690000000017' ProductType: type: integer description: >- Product type: 1 Raw material, 2 Semi-finished good, 3 Finished good, 4 Commercial good, 5 Service. Defaults to 4. format: int32 example: 4 StockType: type: integer description: >- Stock type: 1 No stock tracking, 2 Stock tracking, 3 Lot, 4 FIFO, 5 Serial, 6 LIFO, 7 FEFO. Defaults to 1. format: int32 example: 2 VatRateId: type: - 'null' - string description: ID of the VAT rate from GET /api/v1/definitions/vat-rates. format: uuid AdditionalTaxCode1: type: - 'null' - string description: Additional tax code 1. At most 15 characters. AdditionalTaxRate1: type: number description: Additional tax rate 1, in percent. format: double AdditionalTaxCode2: type: - 'null' - string description: Additional tax code 2. At most 15 characters. AdditionalTaxRate2: type: number description: Additional tax rate 2, in percent. format: double AdditionalTaxCode3: type: - 'null' - string description: Additional tax code 3. At most 15 characters. AdditionalTaxRate3: type: number description: Additional tax rate 3, in percent. format: double IsOutOfUse: type: boolean description: >- Whether the product is out of use. Out of use products are kept but are not offered in new records. example: false ManufacturerCode: type: - 'null' - string description: Manufacturer code. At most 50 characters. SupplierCode: type: - 'null' - string description: Supplier code. At most 50 characters. GroupDetailId1: type: - 'null' - string description: >- ID of a group 1 detail from GET /api/v1/products/groups. Group 1 details never have a parent, so any of them can be selected. format: uuid GroupDetailId2: type: - 'null' - string description: >- ID of a group 2 detail. It must either have no parent or have GroupDetailId1 as its parent. format: uuid GroupDetailId3: type: - 'null' - string description: >- ID of a group 3 detail. It must either have no parent or have GroupDetailId2 as its parent. format: uuid GroupDetailId4: type: - 'null' - string description: >- ID of a group 4 detail. It must either have no parent or have GroupDetailId3 as its parent. format: uuid GroupDetailId5: type: - 'null' - string description: >- ID of a group 5 detail. It must either have no parent or have GroupDetailId4 as its parent. format: uuid ShelfNumber: type: - 'null' - string description: Shelf number. At most 20 characters. example: A-12 Description: type: - 'null' - string description: Description. At most 255 characters. SerialNumberIndex: type: integer description: Serial number index used by serial tracking. format: int32 ECommerceProductCode: type: - 'null' - string description: >- Product code used by the e-commerce integration. At most 50 characters. IsFavourite: type: boolean description: Whether the product is marked as a favourite. example: false Gtip: type: - 'null' - string description: >- Customs tariff (GTIP) number, used on export invoices. At most 20 characters. example: '7318159000' DeliveryTerm: type: - 'null' - string description: >- Delivery term code used on export invoices (Incoterms, e.g. EXW, FCA, CIF). At most 10 characters. example: EXW PackagingType: type: - 'null' - string description: Packaging type code used on export invoices. At most 10 characters. example: BX TransportMode: type: integer description: >- Transport mode used on export invoices: 0 none, 1 Maritime, 2 Rail, 3 Road, 4 Air, 5 Post, 6 Multimodal, 7 Fixed transport installation, 8 Inland waterway. This list is different from the TransportMode of shipment definitions. format: int32 example: 3 Brand: type: - 'null' - string description: Brand. At most 100 characters. Model: type: - 'null' - string description: Model. At most 100 characters. OriginCountryCode: type: - 'null' - string description: >- Country of origin code used on export invoices (ISO 3166-1 alpha-2). At most 10 characters. example: TR Parameters: type: array items: $ref: '#/components/schemas/ProductParameterRequestDto' description: Custom parameter values. Prices: type: array items: $ref: '#/components/schemas/ProductPriceRequestDto' description: >- Prices/discounts. UnitId must be the product's own UnitId, since the product has no second/third unit yet on create. CriticalStock: type: array items: $ref: '#/components/schemas/ProductCriticalStockRequestDto' description: >- Critical stock definitions, one per warehouse. Cannot be sent when StockType is 1 (no stock tracking). DataResultOfProductDetailDto: required: - Success - ResultCode - Data type: object properties: Success: type: boolean description: Whether the operation succeeded. example: true ResultCode: type: string description: >- "0000" on success. On failure, the code of the first error; all errors are listed in Errors. example: '0000' Message: type: - 'null' - string description: >- Error message when Success is false. Messages of all errors are joined into a single text. Data: $ref: '#/components/schemas/ProductDetailDto' ErrorResult: type: object properties: Success: type: boolean description: Whether the operation succeeded. example: false ResultCode: type: - 'null' - string description: >- "0000" on success. On failure, the code of the first error; all errors are listed in Errors. Message: type: - 'null' - string description: >- Error message when Success is false. Messages of all errors are joined into a single text. Errors: type: - 'null' - array items: $ref: '#/components/schemas/ResultError' description: All errors with their codes. Only present when Success is false. ProductParameterRequestDto: type: object properties: ParameterDefinitionId: type: - 'null' - string description: >- Required. ID of a parameter definition from GET /api/v1/products/parameter-definitions. format: uuid Value: description: >- Required. Format depends on the definition type. 0: Text, 1: true/false, 2: Integer, 3: Decimal (dot as separator), 4: Date, 5: Time, 6: Date and time (ISO 8601, e.g. "2026-09-17T14:30:00"). example: Galvaniz ProductPriceRequestDto: type: object properties: PriceType: type: integer description: 'Required. 1: Purchase, 2: Sales.' format: int32 example: 2 Price: type: number description: Required. Must be greater than 0. format: double example: 450 CurrencyId: type: - 'null' - string description: Required. ID of a currency from GET /api/v1/definitions/currencies. format: uuid IncludesVat: type: boolean description: Whether Price includes VAT. example: false Discount: type: number description: >- Discount amount or percentage, depending on IsDiscountPercentage. Cannot be negative. format: double example: 10 IsDiscountPercentage: type: boolean description: >- Whether Discount is a percentage (0-100) rather than a fixed amount. Defaults to true. example: true UnitId: type: - 'null' - string description: >- Required. Must be one of the product's own units: its main unit (UnitId on the product) or, for products with a second/third unit, one of those. format: uuid StartDate: type: - 'null' - string description: Required. Start of the validity period. format: date-time EndDate: type: - 'null' - string description: Required. End of the validity period. Must be after StartDate. format: date-time CustomerId: type: - 'null' - string description: >- Scope: applies only to this customer. Cannot be combined with CustomerGroupId or CustomerGroupDetailId. Leave every scope field empty for a general price. format: uuid CustomerGroupId: type: - 'null' - string description: >- Scope: applies to every customer in this group (from GET /api/v1/customers/groups), unless CustomerGroupDetailId narrows it to one detail. Cannot be combined with CustomerId. format: uuid CustomerGroupDetailId: type: - 'null' - string description: >- Scope: narrows CustomerGroupId to customers with this group detail. Requires CustomerGroupId to be set. format: uuid Description: type: - 'null' - string description: Description. At most 255 characters. ProductCriticalStockRequestDto: type: object properties: WarehouseId: type: - 'null' - string description: Required. ID of a warehouse from GET /api/v1/stock/warehouses. format: uuid MinStock: type: number description: Minimum stock level. Cannot be negative. format: double example: 10 MaxStock: type: number description: >- Maximum stock level. Cannot be negative; 0 means no maximum. When greater than 0, it cannot be less than MinStock. format: double example: 500 MaxStockControl: type: integer description: >- What happens when MaxStock is exceeded. 0: Continue, 1: Warn the user, 2: Stop the operation. format: int32 example: 1 MinStockControl: type: integer description: >- What happens when stock falls below MinStock. 0: Continue, 1: Warn the user, 2: Stop the operation. format: int32 example: 1 NegativeStockControl: type: integer description: >- What happens when stock would go negative. 0: Continue, 1: Warn the user, 2: Stop the operation. format: int32 example: 2 ProductDetailDto: type: object properties: Id: type: string description: Product ID. format: uuid UnitName: type: - 'null' - string description: Name of the main unit. example: ADET VatRate: type: - 'null' - integer description: VAT rate in percent, from the VAT rate definition. format: int32 example: 20 Code: type: - 'null' - string description: >- Required. Product code, unique within the company. Send "Next" to generate it from the "ÜRÜN" serial number definition (create only). At most 50 characters. example: URN-0001 Name: type: - 'null' - string description: Required. Product name. At most 255 characters. example: VİDA 5X40 GALVANİZ UnitId: type: - 'null' - string description: Required. ID of the main unit from GET /api/v1/definitions/units. format: uuid Barcode: type: - 'null' - string description: Barcode of the main unit. At most 30 characters. example: '8690000000017' ProductType: type: integer description: >- Product type: 1 Raw material, 2 Semi-finished good, 3 Finished good, 4 Commercial good, 5 Service. Defaults to 4. format: int32 example: 4 StockType: type: integer description: >- Stock type: 1 No stock tracking, 2 Stock tracking, 3 Lot, 4 FIFO, 5 Serial, 6 LIFO, 7 FEFO. Defaults to 1. format: int32 example: 2 VatRateId: type: - 'null' - string description: ID of the VAT rate from GET /api/v1/definitions/vat-rates. format: uuid AdditionalTaxCode1: type: - 'null' - string description: Additional tax code 1. At most 15 characters. AdditionalTaxRate1: type: number description: Additional tax rate 1, in percent. format: double AdditionalTaxCode2: type: - 'null' - string description: Additional tax code 2. At most 15 characters. AdditionalTaxRate2: type: number description: Additional tax rate 2, in percent. format: double AdditionalTaxCode3: type: - 'null' - string description: Additional tax code 3. At most 15 characters. AdditionalTaxRate3: type: number description: Additional tax rate 3, in percent. format: double IsOutOfUse: type: boolean description: >- Whether the product is out of use. Out of use products are kept but are not offered in new records. example: false ManufacturerCode: type: - 'null' - string description: Manufacturer code. At most 50 characters. SupplierCode: type: - 'null' - string description: Supplier code. At most 50 characters. GroupDetailId1: type: - 'null' - string description: >- ID of a group 1 detail from GET /api/v1/products/groups. Group 1 details never have a parent, so any of them can be selected. format: uuid GroupDetailId2: type: - 'null' - string description: >- ID of a group 2 detail. It must either have no parent or have GroupDetailId1 as its parent. format: uuid GroupDetailId3: type: - 'null' - string description: >- ID of a group 3 detail. It must either have no parent or have GroupDetailId2 as its parent. format: uuid GroupDetailId4: type: - 'null' - string description: >- ID of a group 4 detail. It must either have no parent or have GroupDetailId3 as its parent. format: uuid GroupDetailId5: type: - 'null' - string description: >- ID of a group 5 detail. It must either have no parent or have GroupDetailId4 as its parent. format: uuid ShelfNumber: type: - 'null' - string description: Shelf number. At most 20 characters. example: A-12 Description: type: - 'null' - string description: Description. At most 255 characters. SerialNumberIndex: type: integer description: Serial number index used by serial tracking. format: int32 ECommerceProductCode: type: - 'null' - string description: >- Product code used by the e-commerce integration. At most 50 characters. IsFavourite: type: boolean description: Whether the product is marked as a favourite. example: false Gtip: type: - 'null' - string description: >- Customs tariff (GTIP) number, used on export invoices. At most 20 characters. example: '7318159000' DeliveryTerm: type: - 'null' - string description: >- Delivery term code used on export invoices (Incoterms, e.g. EXW, FCA, CIF). At most 10 characters. example: EXW PackagingType: type: - 'null' - string description: Packaging type code used on export invoices. At most 10 characters. example: BX TransportMode: type: integer description: >- Transport mode used on export invoices: 0 none, 1 Maritime, 2 Rail, 3 Road, 4 Air, 5 Post, 6 Multimodal, 7 Fixed transport installation, 8 Inland waterway. This list is different from the TransportMode of shipment definitions. format: int32 example: 3 Brand: type: - 'null' - string description: Brand. At most 100 characters. Model: type: - 'null' - string description: Model. At most 100 characters. OriginCountryCode: type: - 'null' - string description: >- Country of origin code used on export invoices (ISO 3166-1 alpha-2). At most 10 characters. example: TR Parameters: type: array items: $ref: '#/components/schemas/ProductParameterDto' description: Custom parameter values. Prices: type: array items: $ref: '#/components/schemas/ProductPriceDto' description: Prices/discounts. CriticalStock: type: array items: $ref: '#/components/schemas/ProductCriticalStockDto' description: Critical stock definitions. description: Response data. Null when Success is false. ResultError: required: - Code - Message type: object properties: Code: type: string description: Error code. See the result codes page for the full list. Message: type: string description: Error description. ProductParameterDto: type: object properties: Id: type: string description: Parameter ID. format: uuid ProductId: type: string description: Product ID. format: uuid ParameterDefinitionId: type: - 'null' - string description: Parameter definition ID. format: uuid ParameterName: type: - 'null' - string description: Parameter definition name. example: Malzeme ParameterType: type: - 'null' - integer description: >- 0: Text, 1: Yes/No, 2: Integer, 3: Decimal, 4: Date, 5: Time, 6: Date and time. format: int32 Value: description: Value in the format of ParameterType. ProductPriceDto: type: object properties: Id: type: string description: Price/discount row ID. format: uuid ProductId: type: string description: Product ID. format: uuid CurrencyCode: type: - 'null' - string description: Currency code. example: TRY UnitName: type: - 'null' - string description: Name of the unit, when UnitId is set. CustomerName: type: - 'null' - string description: Name of the customer, when CustomerId is set. CustomerGroupName: type: - 'null' - string description: Name of the customer group, when CustomerGroupId is set. CustomerGroupDetailName: type: - 'null' - string description: >- Name of the customer group detail, when CustomerGroupDetailId is set. PriceType: type: integer description: 'Required. 1: Purchase, 2: Sales.' format: int32 example: 2 Price: type: number description: Required. Must be greater than 0. format: double example: 450 CurrencyId: type: - 'null' - string description: Required. ID of a currency from GET /api/v1/definitions/currencies. format: uuid IncludesVat: type: boolean description: Whether Price includes VAT. example: false Discount: type: number description: >- Discount amount or percentage, depending on IsDiscountPercentage. Cannot be negative. format: double example: 10 IsDiscountPercentage: type: boolean description: >- Whether Discount is a percentage (0-100) rather than a fixed amount. Defaults to true. example: true UnitId: type: - 'null' - string description: >- Required. Must be one of the product's own units: its main unit (UnitId on the product) or, for products with a second/third unit, one of those. format: uuid StartDate: type: - 'null' - string description: Required. Start of the validity period. format: date-time EndDate: type: - 'null' - string description: Required. End of the validity period. Must be after StartDate. format: date-time CustomerId: type: - 'null' - string description: >- Scope: applies only to this customer. Cannot be combined with CustomerGroupId or CustomerGroupDetailId. Leave every scope field empty for a general price. format: uuid CustomerGroupId: type: - 'null' - string description: >- Scope: applies to every customer in this group (from GET /api/v1/customers/groups), unless CustomerGroupDetailId narrows it to one detail. Cannot be combined with CustomerId. format: uuid CustomerGroupDetailId: type: - 'null' - string description: >- Scope: narrows CustomerGroupId to customers with this group detail. Requires CustomerGroupId to be set. format: uuid Description: type: - 'null' - string description: Description. At most 255 characters. ProductCriticalStockDto: type: object properties: Id: type: string description: Critical stock definition ID. format: uuid ProductId: type: string description: Product ID. format: uuid WarehouseName: type: - 'null' - string description: Warehouse name. example: A DEPO WarehouseId: type: - 'null' - string description: Required. ID of a warehouse from GET /api/v1/stock/warehouses. format: uuid MinStock: type: number description: Minimum stock level. Cannot be negative. format: double example: 10 MaxStock: type: number description: >- Maximum stock level. Cannot be negative; 0 means no maximum. When greater than 0, it cannot be less than MinStock. format: double example: 500 MaxStockControl: type: integer description: >- What happens when MaxStock is exceeded. 0: Continue, 1: Warn the user, 2: Stop the operation. format: int32 example: 1 MinStockControl: type: integer description: >- What happens when stock falls below MinStock. 0: Continue, 1: Warn the user, 2: Stop the operation. format: int32 example: 1 NegativeStockControl: type: integer description: >- What happens when stock would go negative. 0: Continue, 1: Warn the user, 2: Stop the operation. format: int32 example: 2 securitySchemes: Bearer: type: http description: Access token obtained from the Noyax auth service with your API key. scheme: bearer bearerFormat: JWT ````