Update discount coupon

Update an existing discount coupon in an Ecwid store referring to its code or ID.

Access scopes

Requires the following access scope: update_discount_coupons

Request

A JSON object with the following fields:

FieldTypeDescription
namestringCoupon title
codestringUnique coupon code, length limit is 128 characters.
discountTypestringDiscount type: ABS, PERCENT, SHIPPING, ABS_AND_SHIPPING, PERCENT_AND_SHIPPING .
statusstringDiscount coupon state: ACTIVE, PAUSED. Discount coupon states EXPIRED and USEDUP are set by Ecwid store only and not available in API
discountnumberDiscount amount
launchDatestringThe date of coupon launch, e.g. 2014-06-06 08:00:00 +0400. Any date provided will be corrected to the UTC timezone
expirationDatestringCoupon expiration date, e.g. 2014-06-06 08:00:00 +0400. Any date provided will be corrected to the UTC timezone
totalLimitnumberThe minimum order subtotal the coupon applies to
usesLimitstringNumber of uses limitation: UNLIMITED, ONCEPERCUSTOMER, SINGLE .
repeatCustomerOnlybooleanDeprecated. Use applicationLimit instead. Coupon usage limitation flag identifying whether the coupon works for all customers or only repeat customers
applicationLimitstringApplication limit for discount coupons. Possible values: "UNLIMITED", "NEW_CUSTOMER_ONLY", "REPEAT_CUSTOMER_ONLY". If you are creating or updating a discount coupon, make sure to use the old repeatCustomerOnly field or the new applicationLimit field only. When both these fields are sent, the priority will be given to the new field – applicationLimit
catalogLimit<DiscountCouponCatalogLimit>The products and categories the coupon can be applied to
shippingLimit<DiscountCouponShippingLimit>Shipping methods, the cost of which will be free after applying the coupon (for 'Free shipping' coupons)

DiscountCouponCatalogLimit

FieldTypeDescription
productsArrayThe list of product IDs the coupon can be applied to
categoriesArrayThe list of category IDs the coupon can be applied to

DiscountCouponShippingLimit

FieldTypeDescription
shippingMethodsArrayThe list of shipping method IDs, the cost of which will be free after applying the coupon

Response

A JSON object of type 'UpdateStatus' with the following fields:

UpdateStatus

FieldTypeDescription
updateCountnumberThe number of updated coupons (1 or 0 depending on whether the update was successful)

Errors

In case of error, Ecwid responds with an error HTTP status code and, optionally, a JSON-formatted body containing error description.

HTTP codes

HTTP StatusResponse JSONDescription
400Request parameters are malformed
403Access token doesn't have update_discount_coupons scope
415Unsupported content-type: expected application/json or text/json
500The request failed because of an error on the server

Error response body (optional)

FieldTypeDescription
errorMessagestringError message
Language
Click Try It! to start a request and see the response here!