Skip to main content
PUT
/
v1
/
promotion-codes
Update promotion code
curl --request PUT \
  --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": {
      "campaign": "summer_sale"
    },
    "additional_info": {
      "redemptions": [
        {
          "redeemed_at": "2025-05-09T07:11:04.000000Z",
          "transaction_key": "order_4561"
        }
      ]
    },
    "times_redeemed": 2
  },
  "status": 1,
  "message": "Promotion code updated 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.

​
Endpoint

PUT https://api.partnero.com/v1/promotion-codes

​
Request Body

ParameterTypeRequiredDescription
codestringYesPromotion code to update. Allowed characters: A-Z, a-z, 0-9, -, _. Max 100 characters
limit_to_specific_partnerbooleanNoRestrict to a specific partner
coupon_specific_partnersobjectYes*Required if limit_to_specific_partner is true. Shape: { id, full_name }
metadataobjectNoCustom key-value pairs (merged into existing metadata)
redeembooleanNoWhen true, records a redemption: increments times_redeemed and appends an entry to additional_info.redemptions
transaction_keystringNoOptional transaction identifier paired with redeem. Must match the key of an existing transaction in this program (created via POST /v1/transactions). Used to deduplicate redemptions — if the same transaction_key was already recorded for this code, or no transaction with that key exists, the request is a silent no-op

​
Request

cURL
curl --location --request PUT 'https://api.partnero.com/v1/promotion-codes' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "code": "PROMO123",
    "metadata": {
      "campaign": "summer_sale"
    }
  }'

​
Record a redemption

Use redeem to record that a customer applied this promotion code, for cases where the checkout doesn’t run through a connected payment integration. Pass a transaction_key to deduplicate retries.
cURL
curl --location --request PUT 'https://api.partnero.com/v1/promotion-codes' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "code": "PROMO123",
    "redeem": true,
    "transaction_key": "order_4561"
  }'

​
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": {
      "campaign": "summer_sale"
    },
    "additional_info": {
      "redemptions": [
        {
          "redeemed_at": "2025-05-09T07:11:04.000000Z",
          "transaction_key": "order_4561"
        }
      ]
    },
    "times_redeemed": 2
  },
  "status": 1,
  "message": "Promotion code updated in the app successfully."
}