What parameters does POST /V1/products/options accept?

This endpoint accepts 1 parameter: option (Magento\Catalog\Api\Data\ProductCustomOptionInterface) required.

POSTCatalog · Magento 2.4.9 Admin · Magento_Catalog::catalog

POST /V1/products/options

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

POST /V1/products/options is a Magento 2 REST endpoint in the Catalog module. Save Custom Option. Requires an admin Bearer token with ACL Magento_Catalog::catalog.

Q: What does POST /V1/products/options return?

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

Q: Does POST /V1/products/options require authentication?

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

POST /V1/products/options is a Magento 2 REST endpoint in the Catalog module. Save Custom Option. Requires an admin Bearer token with ACL Magento_Catalog::catalog.

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

Returns

Magento\Catalog\Api\Data\ProductCustomOptionInterface

Service contract

Magento\Catalog\Api\ProductCustomOptionRepositoryInterface::save

Authorization

Admin Bearer token with ACL:

Magento_Catalog::catalog

Body parameters

option Magento\Catalog\Api\Data\ProductCustomOptionInterface Required

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::catalog

Path

/V1/products/options

Body

{
  "option": {
    "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": ""
      }
    ]
  }
}