Skip to main content
POST
A code that already exists in the target folder is skipped and counted in duplicated. Its stored fields do not change. To overwrite existing coupons, use PUT /coupons/import.
integer
Folder ID. If not provided, coupons are imported into the default folder.
array
required
Array of coupon code strings, up to 50,000 codes. Each code can have up to 255 characters.
string
Expiration date in YYYY-MM-DD format.
string
Discount type: percentual or fixed. Required when value is set.
number
Discount value, greater than 0. The maximum is 100 for percentual and 99999999.99 for fixed. Required when type is set.
string
Three-letter currency code, for example CZK. Required when type is fixed or when min_spend is set.
number
Minimum order value, from 0 to 99999999.99.
string
Shipping rule of the discount: cart, free, or beforeDiscount.
boolean
default:"false"
deprecated
Deprecated. Use PUT /coupons/import instead. When true, only valid_until of the existing coupons is updated and the updated coupons are counted in both duplicated and updated. The request fails with 422 when update_existing is combined with type, value, currency, min_spend, or shipping_price.