---
title: "Create a new product"
method: POST
path: "/api/rest/v1/products-uuid"
tags: ["Product [uuid]"]
---

# Create a new product

`POST /api/rest/v1/products-uuid`

This endpoint allows you to create a new product. In the Enterprise Edition, permissions based on your user groups are applied to the product you try to create. If no uuid is provided, the PIM will generate one for you.

## Request body

- object
  - `uuid` string — Product uuid
  - `enabled` boolean — Whether the product is enabled
  - `family` string — <a href='api-reference-paas.html#Family'>Family</a> code from which the product inherits its attributes and attributes requirements.
  - `categories` string[] — Codes of the <a href='api-reference-paas.html#Category'>categories</a> in which the product is classified
  - `groups` string[] — Codes of the groups to which the product belong
  - `parent` string — Code of the parent <a href='api-reference-paas.html#Productmodel'>product model</a> when the product is a variant (only available since the 2.0). This parent can be modified since the 2.3.
  - `values` object — Product attributes values, see <a href='/concepts/products.html#focus-on-the-product-values'>Product values</a> section for more details
  - `associations` object — Several associations related to groups, product models and/or other products, grouped by association types
    - `associationTypeCode` object
      - `groups` string[] — Array of groups codes with which the product is in relation
      - `products` string[] — Array of product uuids with which the product is in relation
      - `product_models` string[] — Array of product model codes with which the product is in relation (only available since the v2.1)
  - `quantified_associations` object — Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)
    - `quantifiedAssociationTypeCode` object
      - `products` object[] — Array of objects containing product uuids and quantities with which the product is in relation
        - `uuid` string
        - `quantity` integer
      - `product_models` object[] — Array of objects containing product model codes and quantities with which the product is in relation
        - `code` string
        - `quantity` integer
  - `created` string, dateTime — Date of creation
  - `updated` string, dateTime — Date of the last update
  - `metadata` object — More information around the product (only available since the v2.0 in the Enterprise Edition)
    - `workflow_status` 'read_only' | 'draft_in_progress' | 'proposal_waiting_for_approval' | 'working_copy' — Status of the product regarding the user permissions
  - `quality_scores` object — Product quality scores for each channel/locale combination (only available since the 5.0 and when the "with_quality_scores" query parameter is set to "true")
  - `completenesses` object[] — Product completenesses for each channel/locale combination (only available since the 7.0 version, and when the "with_completenesses" query parameter is set to "true")
    - `scope` string
    - `locale` string
    - `data` integer

## Response `201`

Created

## Other responses

- `400` — Bad request
- `401` — Authentication required
- `403` — Access forbidden
- `415` — Unsupported Media type
- `422` — Unprocessable entity

---

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