Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.

Generate Bulk Coupons

POST

https://api.zid.sa/v1/managers/store/coupons/bulk-add

Generate coupons in bulk

🔑Scopes

third_order_write - Coupons Write

Notes

max_weight only applies to free shipping coupons (type: free_shipping).

It works similarly to max_total but limits the total cart weight.

If the total weight exceeds this limit, the coupon will not apply.

This field has no effect on discount or fixed-amount coupon types.

Request

Header Params

Body Params multipart/form-data

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.zid.sa/v1/managers/store/coupons/bulk-add' \
--header 'Authorization: {{Autherization}}' \
--header 'X-Manager-Token: {{Access-Token}}' \
--header 'Accept-Language: en' \
--form 'name="Summer Sale - July 2026"' \
--form 'coupons_amount="2"' \
--form 'discount_type="f"' \
--form 'code="SUMMER2026"' \
--form 'discount="20"' \
--form 'free_shipping="0"' \
--form 'free_cod="0"' \
--form 'total="100"' \
--form 'max_total=""' \
--form 'max_weight=""' \
--form 'date_start="2023-07-01"' \
--form 'date_end="2023-07-31"' \
--form 'uses_total="100"' \
--form 'uses_customer="3"' \
--form 'status="1"' \
--form 'apply_to="all"' \
--form 'applying_method="CODE"' \
--form 'apply_to_array=""' \
--form 'maximum_discount_value=""' \
--form 'is_mazeed_active=""' \
--form 'is_pos_active=""' \
--form 'is_shown_in_pos=""' \
--form 'is_mobile_app_active=""' \
--form 'conditions=""' \
--form 'conditions_criteria="all"' \
--form 'discount_strategy=""' \
--form 'progressive_config.basis=""' \
--form 'progressive_config.tiers=""'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "status": "success",
    "message": {
        "type": "success",
        "code": "MSG_POPUP_OK",
        "name": "Coupons",
        "description": "Coupons created successfully"
    }
}

🟠401Unauthorized

🟠400Bad Request

🟠422Validation Error

🔴500Internal Server error

Modified at 2026-06-15 14:25:46

Create Coupon

Update Coupon