v1
latestOpenAPI 3.1.02026-07-2684271522.2 KBCoupons
Create Coupon
Creates a coupon. Exactly one of amount_off or percent_off must be provided; supplying both, or neither, is rejected. When duration is repeating, duration_in_months is required.
post/v1/coupons
Request body
Example request
{
"coupon": {
"name": "Coupon",
"amount_off": 100,
"duration": "once",
"percent_off": 10,
"max_redemptions": 100,
"metadata": {
"key": "value"
}
}
}Response
An envelope wrapping a single coupon object.
Example response
{
"coupon": {
"coupon_id": "fcoup_1234567890",
"amount_off": 2500,
"duration": "once",
"metadata": {
"order_id": "8842",
"channel": "shopify"
},
"name": "Example",
"valid": false,
"created_at": "2026-06-15T14:30:00Z",
"test_mode": false
}
}