Create Product Option - Salla Merchant API

This endpoint allows you to create a new option for a specific product by passing the product as a path parameter.

Note

For the product.type variable set to product, creating a new product option will generate a new variant for this option.

Important

If you're creating a new physical product with variants, the price must be set after creating options. call the update product SKU to set the price for each variant. Including the price in this case will result on a 422 validation error.

Scopes

products.read_write- Products Read & Write

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Example

{
    "name": "option name",
    "required": true,
    "visibility": "on_condition",
    "visibility_condition_type": "=",
    "visibility_condition_option": 2134428744,
    "visibility_condition_value": 306646512,
    "display_type": "image",
    "values": [
        {
            "name": "value 3",
            "price": "10",
            "is_default": false
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢201Created Successfully

application/json

Body

Examples

ExampleExampleExampleUnauthorized

{
    "status": 201,
    "success": true,
    "data": {
        "id": 1130246629,
        "name": "size",
        "description": "this product is best seller",
        "type": "radio",
        "required": false,
        "associated_with_order_time": 0,
        "sort": 0,
        "display_type": "text",
        "visibility": "always",
        "values": [
            {
                "id": 322122678,
                "name": "XL",
                "price": {
                    "amount": 180,
                    "currency": "SAR"
                },
                "display_value": "XL",
                "option_id": 1130246629,
                "image_url": "https://i.ibb.co/jyqRQfQ/avatar-male.webp",
                "hashed_display_value": "XL"
            }
        ],
        "skus": [
            {
                "id": 652911549,
                "price": {
                    "amount": 150,
                    "currency": "SAR"
                },
                "regular_price": {
                    "amount": 234,
                    "currency": "SAR"
                },
                "stock_quantity": 3000,
                "barcode": "barcode-ABC",
                "sku": "sku-variant-1551119600",
                "related_option_values": [
                    667315336,
                    322122678
                ]
            }
        ]
    }
}

🟠404Not Found

🟠422Error Validation

🟠401Unauthorized