Create Product Variants

This endpoint allows adding or creating variants for a given product. If the specified product is a standalone product (does not have any variants), this operation will convert it into a parent product.

Steps to Create Variants:

1. Create Product Attributes: Create product attributes for the store using the add a new product attribute endpoint.

2. Define Attribute Choices: Define choices (presets) for these attributes using the Create attribute preset Endpoint.

For example, for a size attribute, choices might include 'small', 'medium', 'large', etc. Each choice is an object that accepts values in multiple languages. Currently, English and Arabic are supported. (If a choice is already created, no need to create it again).

3. Variant Generation: Send the details of variants you want to create using this endpoint. Refer to the example request payload below for the required structure.

🔑Scopes

products.read_write - Products Read & Write

Request

Path Params

Header Params

Body Params application/json

Example

{
    "variants": [
        {
            "id": "ebd067c3-6c51-4692-9cac-e43118930ec2",
            "is_deleted": false,
            "sku": "Z.6.1905460000038147819",
            "price": 144,
            "sale_price": null,
            "cost": null,
            "barcode": null,
            "attributes": [
                {
                    "slug": "اللون",
                    "value": {
                        "ar": "ابيض",
                        "en": "White"
                    }
                }
            ],
            "stocks": [
                {
                    "available_quantity": 44,
                    "is_infinite": false,
                    "location": "e2629f14-12ad-4ee4-8103-9db7290c4ccc"
                }
            ],
            "weight": {
                "unit": "kg",
                "value": null
            }
        },
        {
            "is_deleted": false,
            "sku": "Z.6.1905460000038147869",
            "price": 144,
            "sale_price": 122,
            "cost": null,
            "barcode": null,
            "attributes": [
                {
                    "slug": "اللون",
                    "value": {
                        "ar": "اسود",
                        "en": "Black"
                    }
                }
            ],
            "stocks": [
                {
                    "available_quantity": 77,
                    "is_infinite": false,
                    "location": "e2629f14-12ad-4ee4-8103-9db7290c4ccc"
                }
            ],
            "weight": {
                "unit": "kg",
                "value": null
            }
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.zid.sa/v1/products//variants/' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxMTciLCJqdGkiOiJhMTg5ZTg3MmYxMzhkMWVhYjU5MjVkMDkyMGE5NmI0YjliNjg0Y2E2ZTdmM2M2MjljZWYxNmQ4NDJjMmJlYmVhMjI4YTdmMTA0ZWQ4NWE5NCIsImlhdCI6MTY3OTU3Njk5OS41NjY4NzcsIm5iZiI6MTY3OTU3Njk5OS41NjY4OCwiZXhwIjoxNzExMTk5Mzk5LjQ4NjE1Mywic3ViIjoiMTgyNDc1Iiwic2NvcGVzIjpbInRoaXJkLXBhcnRpZXMtYXBpcyJdfQ.i07ef09nVNXGZF-g-QXpNoS2vlFQK_zntAqAMS4Az2XD2EyMLhxLZZRL-QlR11zUPqMmXjMAl_4ooKa3M3zkfZQ6Ga6qStvamk8RnC_39VUx0lfN2A4k65ERZpqwrMy6-t3dE99zay3aicIdNvbgi0zeuMSE5Tn99u-2AtSRa8ffbfAcYPPXacHrhdmlYzdiZS_x_skovFEow1E-nDjdL1WHqO92XdZ7RfNLkiYFTjZlZmM_UruvioaR3q6TXJbqRK_ZrziivezL8ohIQ2SBosUp58I29rlKzvlw_R2j0rKKYZbdxYDaxAHOISmOFKAlO66k7dNevAHI3s4uGIjoGA6ZXHknccWPLLLiaAQ0r64HV8GowW5dg2rhZNurJGDTnLlBQ6F-ql42ptHzSAfzzi576CEoN3gMVpgXcbntUY3reETkFsTBPUjeSuMpANMioXAA0GRp3Ut-84fTnrWxqsCW1WVUIx33HvmfCGPXIdkaCCWoA6G6KXo04MtFbKXQmXkK9esQWI-rqdVnMD3zSR3g3yFHZSL1U-mZeNja03706Rav1ordsRNOtRwtLuoRRbk9KasbUpEwqq4Ao9lqZZwRIjdEw-pQtnUT8V53fhmuuRIefCLFO7eGEtGUnh9o6Uh_pgi6AB6uSlnN9GEMGgI1alqvMmTjxvC-HHt0V-Y' \
--header 'X-Manager-Token: eyJpdiI6Imh3L2dGbmJmRnVCOUY4WW5WQ2s3RFE9PSIsInZhbHVlIjoiZklpRnJyVGV1OWcrZUJBNk44bVp5SjZzSS92V3czcTJjbnJ2dFYvenZ3SFBtWHNSMFU3ZEMzZ0ZJNnpucVE4Ui9rNFdicUduOGpKUlg1VXdGOFFIaVUzZjZyUUZybWx3R0tNY3orUmxoUUUxQ29wSkEyVDZTVnVYb2dlUXJSVzBYVkdESjBpS0xiN05Hbndzc2wzV2N0YitGM1NEdkk4ckZZOTZsTFdEL1ZQRlJJTE5FQmttZng2elpwL1RCeXFRdUd1U3JTc0FHV1kySS80RFJaWlIyZ3gwM2FsQVRFbkt3VWtFOUQyKzdGOD0iLCJtYWMiOiJmZDQ0YzM4ODE0OWQxOWRhYWU0NDhhYmIzYzQ1MDAxMDAzODZjZGM3ZGM4NGJhMGNkMDEyYWZlM2UzYjAxMTI4IiwidGFnIjoiIn0=' \
--header 'Store-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "variants": [
        {
            "id": "ebd067c3-6c51-4692-9cac-e43118930ec2",
            "is_deleted": false,
            "sku": "Z.6.1905460000038147819",
            "price": 144,
            "sale_price": null,
            "cost": null,
            "barcode": null,
            "attributes": [
                {
                    "slug": "اللون",
                    "value": {
                        "ar": "ابيض",
                        "en": "White"
                    }
                }
            ],
            "stocks": [
                {
                    "available_quantity": 44,
                    "is_infinite": false,
                    "location": "e2629f14-12ad-4ee4-8103-9db7290c4ccc"
                }
            ],
            "weight": {
                "unit": "kg",
                "value": null
            }
        },
        {
            "is_deleted": false,
            "sku": "Z.6.1905460000038147869",
            "price": 144,
            "sale_price": 122,
            "cost": null,
            "barcode": null,
            "attributes": [
                {
                    "slug": "اللون",
                    "value": {
                        "ar": "اسود",
                        "en": "Black"
                    }
                }
            ],
            "stocks": [
                {
                    "available_quantity": 77,
                    "is_infinite": false,
                    "location": "e2629f14-12ad-4ee4-8103-9db7290c4ccc"
                }
            ],
            "weight": {
                "unit": "kg",
                "value": null
            }
        }
    ]
}'

Responses

🟢200Product Variants Added Successfully

application/json

Body

Example

{
    "id": "3c58afbb-7b07-4859-b653-b52242a33bb7",
    "name": {
        "ar": "",
        "en": ""
    },
    "sku": "Z.1762848292350157",
    "slug": "3c58afbb-7b07-4859-b653-b52242a33bb7",
    "currency": "SAR",
    "currency_symbol": " SAR ",
    "price": 0,
    "sale_price": null,
    "formatted_price": " SAR 0.00",
    "formatted_sale_price": null,
    "description": {},
    "short_description": {},
    "categories": [],
    "images": [],
    "videos": [],
    "is_draft": true,
    "is_infinite": false,
    "is_taxable": true,
    "requires_shipping": true,
    "group_products": null,
    "custom_option_fields": [],
    "custom_user_input_fields": [],
    "options": [
        {
            "id": "518fe604-8642-4032-b967-0be821ae235d",
            "name": "Color",
            "slug": "اللون",
            "choices": [
                "Black",
                "White"
            ]
        }
    ],
    "related_products": [],
    "related_products_settings": "AUTO_GENERATED",
    "related_products_title": {},
    "badge": null,
    "html_url": "https://mustafastore.localhost:8084/products/3c58afbb-7b07-4859-b653-b52242a33bb7",
    "created_at": "2025-11-11T08:04:52.363138Z",
    "updated_at": "2025-11-11T08:05:16.595741Z",
    "store_id": 6,
    "structure": "parent",
    "stocks": [],
    "variants": [
        {
            "id": "22a32ae6-6c6c-4904-9e2f-9c3a9373f8f1",
            "parent_id": "3c58afbb-7b07-4859-b653-b52242a33bb7",
            "name": {
                "en": " - Black"
            },
            "slug": "en-black",
            "sku": "Z.6.7228299999713898900",
            "price": 0,
            "sale_price": null,
            "is_published": false,
            "is_draft": true,
            "is_infinite": false,
            "is_taxable": true,
            "has_fields": false,
            "has_options": false,
            "created_at": "2025-11-11T08:05:16.588385Z",
            "updated_at": "2025-11-11T08:05:16.588397Z",
            "currency": "SAR",
            "currency_symbol": " SAR ",
            "html_url": "https://mustafastore.localhost:8084/products/en-black",
            "structure": "child",
            "weight": {},
            "stocks": []
        }
    ],
    "weight": {}
}

🟠400Failed Response

🟠401Unauthorized