Skip to main content
POST
/
v1
/
promotion-codes
Create promotion code
curl --request POST \
  --url https://api.example.com/v1/promotion-codes
{
  "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": [],
    "additional_info": [],
    "times_redeemed": 0
  },
  "status": 1,
  "message": "Promotion code created in the app successfully."
}

Documentation Index

Fetch the complete documentation index at: https://docs.partnero.com/llms.txt

Use this file to discover all available pages before exploring further.

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-codes

​
Request Body

ParameterTypeRequiredDescription
coupon_uuidstringYesUUID of the coupon to attach
codestringNoPromotion code (auto-generated if not provided). Allowed characters: A-Z, a-z, 0-9, -, _. Max 100 characters
first_time_orderbooleanNoValid only for first-time orders
limit_to_specific_partnerbooleanNoRestrict to a specific partner
coupon_specific_partnersobjectYes*Required if limit_to_specific_partner is true. Shape: { id, full_name }
limit_to_specific_customerbooleanNoRestrict to a specific customer
coupon_specific_customersobjectYes*Required if limit_to_specific_customer is true. Shape: { id, customer_full_name }
limit_to_specific_subscriberbooleanNoRestrict to a specific newsletter subscriber
coupon_specific_subscribersobjectYes*Required if limit_to_specific_subscriber is true. Shape: { id, subscriber_full_name }
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-codes' \
  --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": [],
    "additional_info": [],
    "times_redeemed": 0
  },
  "status": 1,
  "message": "Promotion code created in the app successfully."
}