# Overview

Promotions are marketing tools designed to attract new users and increase sales. Using Xsolla API, you can configure the following promotions:

* Discounts — reduced prices on selected items.
* Bonuses — items granted to users along with their purchase.
* Coupons — codes that allow users to receive one or more bonus items when redeeming.
* Promo codes — codes that allow users to receive bonus items, a discount on a specific item, or a discount on the entire cart. Unlike coupons that are redeemed after the user enters them, promo codes are redeemed during a purchase (at checkout).
* Unique offers — hidden items displayed in the catalog to users who have entered a unique offer code. If the code is not entered, the items are not displayed.

Example flow for configuring a discount promotion:
1. Create items using the calls from the **Admin** subsection of the [Virtual items and currency](/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list/), [Bundles](/api/catalog/bundles-admin/admin-create-bundle), or [Game keys](/api/catalog/game-keys-admin) groups.
2. Create a promotion using the [Create discount promotion for item](/api/liveops/promotions-discounts/create-item-promotion/) call. In the `items` array, pass the necessary item SKUs.
3. Set up promotion validity periods. To do this, call the [Create discount promotion for item](/api/liveops/promotions-discounts/create-item-promotion/) or [Update item promotion](/api/liveops/promotions-discounts/update-item-promotion/) methods, and pass the `promotion_periods` field as an array of objects where `date_from` defines the start, and `date_until` defines the end date of the validity period.
4. Activate a promotion using the [Update item promotion](/api/liveops/promotions-discounts/update-item-promotion/) call. Pass the `"is_enabled": true` parameter.
5. To get information about item prices, including discounted prices, call the client API methods for getting an item catalog from the [Common > Catalog](/api/catalog/tag/common-catalog/), [Virtual Items and Currency > Catalog](/api/catalog/virtual-items-currency-catalog/get-virtual-items/), and [Bundles > Catalog](/api/catalog/bundles-catalog/get-bundle-list/) subsections.

![Promotion configuration example](https://cdn.xsolla.net/developers/current/images/api_docs/promo-overview.svg)

Refer to our documentation for detailed information about configuring promotions:
* [Discounts](https://developers.xsolla.com/liveops/promotion-tools/discounts/)
* [Bonuses](https://developers.xsolla.com/liveops/promotion-tools/bonuses/)
* [Coupons](https://developers.xsolla.com/liveops/promotion-tools/coupons/)
* [Promo codes](https://developers.xsolla.com/liveops/promotion-tools/promo-codes/)
* [Unique catalog offers](https://developers.xsolla.com/liveops/promotion-tools/unique-offer/)