Create Coupon
POST
https://api.zid.sa/v1/managers/store/coupons/add
Notes
max_weight only applies to free shipping coupons (type: free_shipping). max_total but limits the total cart weight.Request
Header Params
Body Params application/x-www-form-urlencoded
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.zid.sa/v1/managers/store/coupons/add' \
--header 'Authorization: {{Autherization}}' \
--header 'X-Manager-Token: {{Access-Token}}' \
--header 'Accept-Language: en' \
--data-urlencode 'name=Summer Sale 3 - July 2026' \
--data-urlencode 'code=SUMMER20263' \
--data-urlencode 'discount_type=f' \
--data-urlencode 'discount=20' \
--data-urlencode 'free_shipping=0' \
--data-urlencode 'free_cod=0' \
--data-urlencode 'status=1' \
--data-urlencode 'applying_method=CODE' \
--data-urlencode 'apply_to=all' \
--data-urlencode 'is_mazeed_active=0' \
--data-urlencode 'is_pos_active=0' \
--data-urlencode 'is_shown_in_pos=0' \
--data-urlencode 'is_mobile_app_active=0' \
--data-urlencode 'conditions_criteria=any' \
--data-urlencode 'conditions%5B0%5D%5Bfield%5D=customer_location' \
--data-urlencode 'conditions%5B0%5D%5Boperator%5D==' \
--data-urlencode 'conditions%5B0%5D%5Baction%5D=INCLUDE' \
--data-urlencode 'conditions%5B0%5D%5Bvalue%5D=1' \
--data-urlencode 'discount_strategy=progressive' \
--data-urlencode 'progressive_config.basis=subtotal' \
--data-urlencode 'progressive_config.tiers%5B0%5D%5Bthreshold%5D=1' \
--data-urlencode 'progressive_config.tiers%5B0%5D%5Bvalue%5D=1' \
--data-urlencode 'progressive_config.tiers%5B0%5D%5Bmaximum_discount_value%5D=1'Response Response Example
200 - Success
{
"status": "object",
"coupon": {
"coupon_id": 6336925,
"id": 6336925,
"store_id": 3,
"store_name": "متجر أسامة.",
"store_logo": null,
"code": "SUMMER20262",
"uses_total": 0,
"created_at": "2026-06-15T14:23:36.000000Z",
"name": "Summer Sale 2 - July 2026",
"total_usage": null,
"discount_type": "f",
"applying_method": "CODE",
"discount_strategy": "standard",
"progressive_config": null,
"conditions": null,
"conditions_criteria": "all",
"discount": 20,
"logged": false,
"free_shipping": false,
"free_cod": false,
"apply_to": "all",
"total": 0,
"max_total": 0,
"max_weight": 0,
"date_start": "2026-06-15",
"date_end": "2026-07-15",
"uses_customer": 0,
"coupon_status": false,
"status_code": "coupon_inactive",
"maximum_discount_value": null,
"orders": [],
"total_sales": 0,
"total_customers": 0,
"note": null,
"is_mazeed_active": false,
"is_pos_active": false,
"is_shown_in_pos": false,
"is_mobile_app_active": false,
"is_manageable": true,
"is_active": false,
"enabled": false,
"apply_to_data": []
},
"message": {
"type": "object",
"code": null,
"name": null,
"description": null
}
}Modified at 2026-06-23 12:29:56