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 appear under the Promotions tab.

Promotions API endpoints

Use the following two Promotions endpoints:

• /promotions endpoint - Create, update, activate, and deactivate promotions
• /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 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 answers common questions around integration and troubleshooting.
• Learn more about the Promotions API solution in Connectivity Hub.
• Learn more about the Promotions offered by Booking.com 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.