Create a coupon | FluxStore Docs

POST/api/v1/coupons

Create a new coupon.

Requires the Coupons:Edit permission.

Body

codestringrequired

The coupon code customers will enter.

discountTypestringrequired

Discount calculation method.

Values:: percentagefixed

discountValuenumberrequired

Percent (0–100) or fixed amount.

applicationScopestringrequired

What the coupon applies to.

Values:: packagescategoriesstore

packageScopestring

Required when applicationScope is packages.

Values:: allspecific

packageIdsstring[]· uuid

Required when packageScope is specific.

maxUsesinteger

Total use cap.

maxUsesPerUserinteger

Per-customer use cap.

validFromstring· date-time

Earliest valid date.

validUntilstring· date-time

Latest valid date.

isActiveboolean

Whether the coupon is enabled. Defaults to true.

POST/api/v1/coupons


curl -X POST \
  -H "X-Api-Key: flx_XXXX_XXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "SUMMER25",
    "discountType": "percentage",
    "discountValue": 25,
    "applicationScope": "packages",
    "packageScope": "all",
    "maxUses": 100,
    "maxUsesPerUser": 1,
    "validFrom": "2026-06-01T00:00:00Z",
    "validUntil": "2026-09-01T00:00:00Z",
    "isActive": true
  }' \
  https://api.fluxstore.net/api/v1/coupons

200OK


{
  "success": true,
  "data": {
    "id": "cp_a1b2c3...",
    "code": "SUMMER25",
    "isActive": true
  }
}