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

Update Bulk Coupons

PUT

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

This endpoint allows merchants to update details of an existing coupons. Merchants can modify attributes such as discount value, expiration date, and usage limits.

🔑Scopes

coupons.read_write - Coupons Read & 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 application/x-www-form-urlencoded

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.zid.sa/v1/managers/store/coupons/bulk-update' \
--header 'Authorization: {{Autherization}}' \
--header 'X-Manager-Token: {{Access-Token}}' \
--header 'Accept: application/json' \
--header 'Accept-Language: en' \
--data-urlencode 'coupons_ids%5B%5D=6351724' \
--data-urlencode 'coupons_ids%5B%5D=6351723' \
--data-urlencode 'discount_type=f' \
--data-urlencode 'discount=155' \
--data-urlencode 'free_shipping=0' \
--data-urlencode 'free_cod=0' \
--data-urlencode 'total=0' \
--data-urlencode 'max_total=' \
--data-urlencode 'max_weight=' \
--data-urlencode 'date_start=2021-02-10' \
--data-urlencode 'date_end=2021-02-28' \
--data-urlencode 'uses_total=1000' \
--data-urlencode 'uses_customer=1000' \
--data-urlencode 'status=1' \
--data-urlencode 'apply_to=all' \
--data-urlencode 'applying_method=CODE' \
--data-urlencode 'apply_to_array=' \
--data-urlencode 'maximum_discount_value=' \
--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=all' \
--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'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

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

🟠401Unauthorized

🟠422Validation Error

🔴500Internal Server error

🟠422Unprocessable Entity

Modified at 2026-06-22 14:18:50

Update Coupon

Update Coupon Status