Create Coupon

View as Markdown

Request

This endpoint expects a multipart form.
namestringRequired

Required: Coupon name - max 255 chars - “Summer Sale”

currencystringRequired

Optional: Currency code for amount_off - 3 chars - “USD”

durationstringRequired

Required: Coupon duration - once|repeating|forever - “repeating”

amount_offstringRequired

Optional: Fixed amount discount in cents - numeric min:1 - required without percent_off - 500

expires_atstringRequired

Optional: Expiration date - date after today - “2027-12-31”

percent_offstringRequired

Optional: Percentage discount - numeric 0.01-100 - required without amount_off - 20

max_redemptionsstringRequired

Optional: Maximum number of redemptions - integer min:1 - 100

duration_in_monthsstringRequired

Optional: Months for repeating duration - integer min:1 - required if duration=repeating - 3

Response

Successful response