Create Promotion Code

POST

/admin/platform-billing/coupons/%7Bcoupon_uuid%7D/promotion-codes

This endpoint expects a multipart form.

codestringRequired

Required: Promotion code - max 50 chars unique uppercase alphanumeric+underscore - “SUMMER2026”

expires_atstringRequired

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

max_redemptionsstringRequired

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

first_subscription_onlystringRequired

Optional: Only for first subscription - boolean - true

Successful response

1	curl -X POST https://https//https/admin/platform-billing/coupons/%7Bcoupon_uuid%7D/promotion-codes \
2	-H "Content-Type: multipart/form-data" \
3	-F code="SUMMER2026" \
4	-F expires_at="2027-12-31" \
5	-F max_redemptions="25" \
6	-F first_subscription_only="true"