Create Product
POST
https://api.zid.sa/v1/products/
standard products, grouped products, vouchers, downloadable products, crowdfunding projects, donation items, customizable products, and dynamic bundle products.Supported product classes
| Product Class | Use Case | Additional Step Required |
|---|---|---|
| Standard Product | Regular physical or digital product. | No |
grouped_product | Bundle multiple existing products together as one product. | No |
voucher | Digital voucher, gift card, or license key product. | May require voucher setup after product creation. |
downloadable | Digital file product. | Files are managed separately after product creation. |
crowdfunding_project | Fundraising product with goal tracking. | No |
donation_item | Donation product with unit-based progress tracking. | No |
dynamic_bundle | Customer-selectable bundle with selection groups. | Yes. Selection groups must be created separately. |
| Customizable Product | Product with custom input fields or custom option fields. | No |
Features
Important Notes
1.
To assign a product to one or more categories, use the following endpoints after creation:
2.
3.
4.
sale_price, quantity, is_infinite, or requires_shipping.Dynamic Bundle flow
1.
POST /v1/products/2.
PATCH /v1/products/{product_id}/selection-groups/bulk-patch/1.
POST /v1/products/2.
PATCH /v1/products/{product_id}/selection-groups/bulk-patch/3.
PATCH /v1/products/{product_id}/The Dynamic Bundle selection groups endpoint is currently not published.
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.zid.sa/v1/products/' \
--header 'Authorization: {{Autherization}}' \
--header 'X-Manager-Token: {{Access-Token}}' \
--header 'Store-Id: {{StoreId}}' \
--header 'Accept-Language: en' \
--header 'Role: Manager' \
--header 'Content-Type: application/json' \
--data '{
"name": {
"ar": "منتج شامل",
"en": "Comprehensive Product"
},
"description": {
"ar": "منتج يوضح جميع الميزات المتاحة",
"en": "Product showcasing all available features"
},
"short_description": {
"ar": "منتج شامل مع جميع الميزات",
"en": "Comprehensive product with all features"
},
"sku": "FULL-001",
"barcode": "1234567890128",
"price": 199.99,
"sale_price": 149.99,
"cost": 80.00,
"quantity": 100,
"is_infinite": false,
"is_draft": false,
"is_published": true,
"is_taxable": true,
"requires_shipping": true,
"weight": {
"value": 1.5,
"unit": "kg"
},
"categories": [
1,
2,
3
],
"keywords": [
"product",
"complete",
"featured"
],
"display_order": 1,
"seo": {
"title": {
"ar": "منتج شامل - متجر متقدم",
"en": "Comprehensive Product - Advanced Store"
},
"description": {
"ar": "اكتشف منتجنا الشامل بميزات متقدمة",
"en": "Discover our comprehensive product with advanced features"
}
},
"purchase_restrictions": {
"min_quantity_per_cart": 1,
"max_quantity_per_cart": 5,
"availability_period_start": "2024-01-01T00:00:00Z",
"availability_period_end": "2024-12-31T23:59:59Z",
"sale_price_period_start": "2024-01-01T00:00:00Z",
"sale_price_period_end": "2024-03-31T23:59:59Z"
},
"badge": {
"body": {
"ar": "خصم {discount_percent}",
"en": "Discount {discount_percent}"
}
}
}'Response Response Example
201 - Dynamic Bundle
{
"id": "product-uuid",
"name": {
"ar": "حزمة البناء المخصصة",
"en": "Custom Build Bundle"
},
"product_class": "dynamic_bundle",
"sku": "BUNDLE-001",
"price": 0,
"is_draft": false,
"is_published": false,
"requires_shipping": true,
"meta": {
"location_id": "dd125776-70d1-4819-934c-a29b8ebd18ca"
},
"selection_groups": []
}Modified at 2026-06-10 07:51:16