What does POST /V1/products return?

The endpoint returns Magento\Catalog\Api\Data\ProductInterface.

POSTCatalog · Magento 2.4.9 Admin · Magento_Catalog::products

POST /V1/products

Q: What does the POST /V1/products endpoint do in Magento 2?

POST /V1/products is a Magento 2 REST endpoint in the Catalog module. Create product. Requires an admin Bearer token with ACL Magento_Catalog::products.

Q: What parameters does POST /V1/products accept?

This endpoint accepts 2 parameters: product (Magento\Catalog\Api\Data\ProductInterface) required; saveOptions (bool).

Q: Does POST /V1/products require authentication?

This endpoint requires an admin Bearer token with ACL: Magento_Catalog::products.

POST /V1/products is a Magento 2 REST endpoint in the Catalog module. Create product. Requires an admin Bearer token with ACL Magento_Catalog::products.

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

Magento\Catalog\Api\Data\ProductInterface

Service contract

Magento\Catalog\Api\ProductRepositoryInterface::save

Authorization

Admin Bearer token with ACL:

Magento_Catalog::products

Body parameters

product Magento\Catalog\Api\Data\ProductInterface Required

saveOptions bool default: false

Example request

Auto-generated from the service contract — paste-ready against your store's /rest/default base. Replace the host, store code, ACL token, and any required values before running.

Headers

application/json

Content-Type

application/json

Authorization

Bearer <ACCESS_TOKEN> admin token with ACL: Magento_Catalog::products

Path

/V1/products

Body

{
  "product": {
    "attribute_set_id": 0,
    "created_at": "",
    "custom_attributes": [
      {
        "attribute_code": "",
        "value": ""
      }
    ],
    "extension_attributes": {},
    "id": 0,
    "media_gallery_entries": [
      {
        "content": {
          "base64_encoded_data": "",
          "name": "",
          "type": ""
        },
        "disabled": false,
        "extension_attributes": {},
        "file": "",
        "id": 0,
        "label": "",
        "media_type": "",
        "position": 0,
        "types": [
          {}
        ]
      }
    ],
    "name": "",
    "options": [
      {
        "extension_attributes": {},
        "file_extension": "",
        "image_size_x": 0,
        "image_size_y": 0,
        "is_require": false,
        "max_characters": 0,
        "option_id": 0,
        "price": 0,
        "price_type": "",
        "product_sku": "",
        "sku": "",
        "sort_order": 0,
        "title": "",
        "type": "",
        "values": [
          {
            "option_type_id": 0,
            "price": 0,
            "price_type": "",
            "sku": "",
            "sort_order": 0,
            "title": ""
          }
        ]
      }
    ],
    "price": 0,
    "product_links": [
      {
        "extension_attributes": {},
        "link_type": "",
        "linked_product_sku": "",
        "linked_product_type": "",
        "position": 0,
        "sku": ""
      }
    ],
    "sku": "",
    "status": 0,
    "tier_prices": [
      {
        "customer_group_id": 0,
        "extension_attributes": {},
        "qty": 0,
        "value": 0
      }
    ],
    "type_id": "",
    "updated_at": "",
    "visibility": 0,
    "weight": 0
  },
  "saveOptions": false
}