---
title: "Configuring promotions"
slug: "configuring-promotions"
tags: ["config api", "Associate App", "reason codes", "promotions", "price override", "order", "tutorial", "api", "discounts", "automatic promotions", "coupons"]
updated: 2025-07-09T14:40:47Z
published: 2025-07-09T14:40:47Z
canonical: "docs.newstore.com/configuring-promotions"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.newstore.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuring promotions

## Configuring a global exclusion list

You can create a list of products that must never be discounted during a purchase. For example, products like gift cards and carry bags are never discounted by a retailer.

Products in the exclusion list will not be discounted when an order discount, an item discount, or a coupon code is applied to the cart. Automatic promotions cannot be applied to these products either.

To check the current list of global excluded products for your business, use the [Get promotions config](https://docs.newstore.net/api/integration/discounts-promos/promotions_configuration_api#operation/getGlobalExclusion) method.

To modify a list of global excluded products:

1. Use the [Update promotions config](https://docs.newstore.net/api/integration/discounts-promos/promotions_configuration_api#operation/updateGlobalExclusion), or [delete promotions config](https://docs.newstore.net/api/integration/discounts-promos/promotions_configuration_api#operation/deleteGlobalExclusion) method.
2. For updating the list, in the `ids` property, specify a list of product IDs to which no discounts or promotions can be applied during checkout.

## Configuring reason codes for manual discounts and price overrides

You can create a list of reason codes for manual discounts and price overrides. Associates can use these to specify reasons to offer manual discounts to a customer. If no reason codes are specified for a given catalog, the Associate App will display a free text field to enter the reason for the discount. You can configure the reason codes when offering manual discounts on:

- The whole cart or order, or
- Individual items

> [!TIP]
> Note
> 
> This feature is not available when the Associate App is offline.

To view the list of reason codes, use the [List reason codes](https://docs.newstore.net/api/integration/discounts-promos/reason-codes-promotions-api#tag/Reason-Codes/operation/listReasonCodes) method.

To create a new reason code:

1. Use the [Create reason codes](https://docs.newstore.net/api/integration/discounts-promos/reason-codes-promotions-api#tag/Reason-Codes/operation/createReasonCode) method.
2. Specify a code for the reason in `code` and a relevant name in `name`.

For example, `dmgd` and `Damaged` for manual discounts to be offered on damaged or defected items in the store.

These reasons will be available in the app for the associate when offering manual discounts to the customer. See [Adding discounts and redeeming coupons](/v1/docs/using-newstore-associate-app#adding-discounts-and-redeeming-coupons).

> [!NOTE]
> Important
> 
> - Ensure that the value defined in the `Accept-Language` property matches the locale set for the store.
> - To display a free-text field for associates to enter a custom reason, ensure that you **do not** create a reason code for the store's specified locale.

To update a reason code, use the [Update reason code](https://docs.newstore.net/api/integration/discounts-promos/reason-codes-promotions-api#tag/Reason-Codes/operation/updateReasonCode) method.

To delete a reason code, use the [Delete reason codes](https://docs.newstore.net/api/integration/discounts-promos/reason-codes-promotions-api#tag/Reason-Codes/operation/destroyReasonCode) method.