Create Discount Rule

Developing

POST

https://api.zid.sa/v1/managers/store/discounts

Create a new discount rule

🔑Scopes

third_coupons_write - Coupons Write

Request

Header Params

Body Params application/x-www-form-urlencoded

Responses

🟢200OK

application/json

Bodyapplication/json

🟠401Unauthorized

🔴500Internal Server error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.zid.sa/v1/managers/store/discounts' \
--header 'Authorization: {{Autherization}}' \
--header 'X-Manager-Token: {{Access-Token}}' \
--header 'Accept-Language: en' \
--header 'Accept: application/json' \
--data-urlencode 'code=test1113' \
--data-urlencode 'name%5Bar%5D=ar' \
--data-urlencode 'name%5Ben%5D=en' \
--data-urlencode 'description%5Bar%5D=ar' \
--data-urlencode 'description%5Ben%5D=en' \
--data-urlencode 'uses_total=1' \
--data-urlencode 'uses_customer=1' \
--data-urlencode 'conditions_criteria=all' \
--data-urlencode 'status=0' \
--data-urlencode 'start_date=2026-06-01' \
--data-urlencode 'end_date=2026-06-30' \
--data-urlencode 'conditions%5B0%5D%5Bfield%5D=source' \
--data-urlencode 'conditions%5B0%5D%5Boperator%5D==' \
--data-urlencode 'conditions%5B0%5D%5Bvalue%5D=mobile_app' \
--data-urlencode 'conditions%5B0%5D%5Bapplies_to%5D=all_products' \
--data-urlencode 'conditions%5B0%5D%5Bproduct_ids%5D=' \
--data-urlencode 'conditions%5B0%5D%5Bcategory_ids%5D=' \
--data-urlencode 'actions%5B0%5D%5Bfield%5D=subtotal' \
--data-urlencode 'actions%5B0%5D%5Btype%5D=percentage' \
--data-urlencode 'actions%5B0%5D%5Bvalue%5D=20' \
--data-urlencode 'actions%5B0%5D%5Bapplies_to%5D=all_products' \
--data-urlencode 'actions%5B0%5D%5Bproduct_ids%5D=' \
--data-urlencode 'actions%5B0%5D%5Bcategory_ids%5D=' \
--data-urlencode 'actions%5B0%5D%5Bproducts_quantity%5D=1' \
--data-urlencode 'actions%5B0%5D%5Bfree_item_selection_strategy%5D=lowest' \
--data-urlencode 'auto_adding=0'

Response Example

200 - Success

{
    "status": "object",
    "discount_rule": {
        "id": "0558bca4-70e6-4503-8b2d-e04f164f97ef",
        "name": {
            "ar": "ar",
            "en": "en"
        },
        "description": {
            "ar": "ar",
            "en": "en"
        },
        "code": "test1113",
        "conditions": [
            {
                "field": "source",
                "operator": "=",
                "value": "mobile_app",
                "applies_to": "all_products",
                "product_ids": null,
                "category_ids": null
            }
        ],
        "actions": [
            {
                "field": "subtotal",
                "type": "percentage",
                "value": "20",
                "applies_to": "all_products",
                "product_ids": null,
                "category_ids": null,
                "products_quantity": "1",
                "free_item_selection_strategy": "lowest"
            }
        ],
        "conditions_criteria": "all",
        "uses_total": "1",
        "uses_customer": "1",
        "enabled": true,
        "auto_adding": null,
        "status_code": "active",
        "start_date": "2026-06-01",
        "end_date": "2026-06-30",
        "meta": null,
        "channel": null,
        "channel_name": null
    },
    "message": {
        "type": "object",
        "code": null,
        "name": null,
        "description": null
    }
}

Modified at 2026-06-24 15:27:30

View Discount Rule

Update Discount Rule