Create Promo Code List

Promo code lists contain large sets of promo codes. When defining a promo code list, you can specify its name, its date range, the points it can aware, and, perhaps most importantly, whether the list is for single-use, multi-use, or third-party promo codes.

Single-use codes are randomly generated and unique; they can be claimed only once. Setting the codes for single use is an excellent way to target the use to a very specific set of customers.

Alternatively, multi-use codes can be claimed multiple times. For this type of list, you can set a cap on the list and thereby help prevent fraud and limit liability. Codes acquired from a third party provider can also be assigned to a promo code list. They can then be activated and validated when a customer entes a promo code value.

For more information on choosing a promo code type, see Step 1 of the Create promo code procedural document.

Sequence Diagram

See the overall flow for this task below.

DEVELOPER/ADMIN DEVELOPER/ADMIN CLIENT MIDDLEWARE CLIENT MIDDLEWARE SESSIONM SESSIONM CREATE PROMO CODE LIST Access platform development environment Create promo code list Send success message

Best Practices

As you build applications or web sites that implement SessionM APIs to support promo codes, bear in mind these best practices:

  • You may want to consider using caps to limit the number of claims against a list or a promo code. Doing so limits liability because you are capping the maximum amount of money that can be spent on a given promo code or promo code list.
  • Caps limit the number of successful code entries for the life of a specific promo code list.
  • When defining the request object for the endpoint that creates a promo code list using POST /priv/v1/apps/:api_key/promotions, you can specify a value for global_entry_cap, which sets a maximum number of codes that can be redemeed for a promo code list.