Update a Coupon

put

https://api.ecartapi.com/api/v2/coupons/{couponId}

Update an existing coupon's configuration. Common updates include modifying discount values, extending validity dates, adjusting usage limits, and enabling or disabling the coupon. Updatable fields vary by platform.

Note: Refer to the platform-specific endpoint for supported update fields.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Available platforms

This endpoint is supported by 4 platforms. Click on each platform to see its specific updatable fields and required parameters.

Mercado Libre · Shopify · Tray · WooCommerce

Updatable fields vary by platform. Refer to the platform-specific endpoint for supported update fields.

Path Params

couponId

string

required

The unique identifier of the coupon in the connected platform.

Body Params

Coupon fields to update. Send only the fields you want to change — omitted fields are not modified. Available fields vary by platform.

code

string

Updated coupon code. Note that changing the code will invalidate any existing uses of the previous code.

discountType

string

Updated discount type: percentage or fixed.

discountValue

number

Updated discount amount or percentage value.

minimumOrderAmount

number

Updated minimum order subtotal required to apply this coupon. Set to 0 to remove the minimum.

usageLimit

integer

Updated maximum number of times this coupon can be used. Set to null for unlimited usage.

active

boolean

Set to false to deactivate the coupon without deleting it. Set to true to reactivate it.

dates

object

Updated validity period for the coupon.

Response

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Available platforms

200Successful response