# Understanding promotions

You can use the Promotions API to create and manage promotions. Promotions allow properties to offer discounts, which are expressed as a percentage off the original price, never a fixed amount.

Use the Promotions API to:

- Create a promotion
- Update an existing promotion to change its active dates, discount level and more
- Activate/deactivate a promotion
- View promotion details


Promotions in the [extranet](https://admin.booking.com) appear under the **Promotions** tab.

## Promotions API endpoints

Use the following two Promotions endpoints:

- [/promotions](/connectivity/docs/b_xml-promotions) endpoint - Create, update, activate, and deactivate promotions
- [/getpromotions](/connectivity/docs/b_xml-getpromotions) endpoint - Retrieve existing promotions details


## Getting started with the Promotions API

To access the Promotions API, you need the appropriate machine account permissions. Contact [Connectivity Support](https://portal.connectivity.booking.com/s/CaseForm?language=en_US) to request them.

These resources will also help you get started:

- Our Handbook for Providers and Channel Managers explains how the Promotions API benefits both connectivity providers and properties. It also gives non-technical background information about promotions.
- The [FAQ page](/connectivity/docs/con-faq-promotions) answers common questions around integration and troubleshooting.
- Learn more about the [Promotions API solution](https://connectivity.booking.com/s/solution-article/promotions-api-MC2S5I2TUTRFF7LDP22CMMTYZUFQ?language=en_US) in Connectivity Hub.
- Learn more about the [Promotions offered by Booking.com](https://partner.booking.com/en-gb/solutions/promotions-0) in Partner Hub.


## Going live

Before you go live with your Promotions API integration, we recommend contacting your account manager. They can help you promote your integration to connected properties.

You'll need to meet certain requirements before you can go live. For more information, see [Going Live.](/connectivity/docs/going_live/)