Skip to main content
POST
/
v1
/
promotion-code
Create promotion code
curl --request POST \
  --url https://api.example.com/v1/promotion-code
{
  "data": {
    "code": "PROMO123",
    "first_time_order": true,
    "limit_to_specific_partner": false,
    "coupon_specific_partners": [],
    "limit_to_specific_customer": false,
    "coupon_specific_customers": [],
    "minimum_order_status": true,
    "minimum_order_value": 22,
    "expiration_date_status": false,
    "expiration_date_value": null,
    "redemption_times_status": false,
    "redemption_times_value": null,
    "metadata": []
  },
  "status": 1,
  "message": "Promotion code created in the app successfully."
}
A promotion code is attached to a coupon and can have additional restrictions like partner limits, minimum orders, and expiration dates.

​
Endpoint

POST https://api.partnero.com/v1/promotion-code

​
Request Body

ParameterTypeRequiredDescription
coupon_uuidstringYesUUID of the coupon to attach
codestringNoPromotion code (auto-generated if not provided)
first_time_orderbooleanNoValid only for first-time orders
limit_to_specific_partnerbooleanNoRestrict to specific partner
coupon_specific_partnersarrayYes*Required if limit_to_specific_partner is true
limit_to_specific_customerbooleanNoRestrict to specific customer
coupon_specific_customersarrayYes*Required if limit_to_specific_customer is true
minimum_order_statusbooleanNoEnable minimum order requirement
minimum_order_valueintegerYes*Required if minimum_order_status is true
expiration_date_statusbooleanNoEnable expiration date
expiration_date_valuedateYes*Required if expiration_date_status is true
redemption_times_statusbooleanNoEnable redemption limit
redemption_times_valueintegerYes*Required if redemption_times_status is true
metadataobjectNoCustom key-value pairs

​
Request

cURL
curl --location 'https://api.partnero.com/v1/promotion-code' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "coupon_uuid": "coupon_123",
    "code": "PROMO123",
    "first_time_order": true,
    "minimum_order_status": true,
    "minimum_order_value": 22
  }'

​
Response

{
  "data": {
    "code": "PROMO123",
    "first_time_order": true,
    "limit_to_specific_partner": false,
    "coupon_specific_partners": [],
    "limit_to_specific_customer": false,
    "coupon_specific_customers": [],
    "minimum_order_status": true,
    "minimum_order_value": 22,
    "expiration_date_status": false,
    "expiration_date_value": null,
    "redemption_times_status": false,
    "redemption_times_value": null,
    "metadata": []
  },
  "status": 1,
  "message": "Promotion code created in the app successfully."
}