Create a new voucher

Overview

Create discount vouchers that customers can apply to their bookings. Supports percentage discounts, fixed amounts, and points redemption vouchers.

When to Use

  • Promotional campaigns - Create discount codes for marketing
  • Customer rewards - Generate vouchers for loyal customers
  • Special offers - Create time-limited discount vouchers
  • Points redemption - Generate vouchers from loyalty points

What You Get

  • Voucher object - Complete voucher details including code and settings
  • Usage tracking - Remaining uses count
  • Validation - Confirmation that the voucher was created successfully

Key Features

  • Multiple discount types - Percentage, fixed amount, or points redemption
  • Flexible rules - Set minimum spend, maximum discount, and usage limits
  • Validity control - Define start and end dates
  • Guest assignment - Optionally assign to specific guests

Quick Start

Provide voucher code, discount type, value, currency, validity dates, usage limits, and status. Returns the created voucher with all details.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

A unique code for the new voucher. e.g. manhattan-holidays-100

string
required

Type of discount, such as percentage, or points_redemption

number
required

Value of the discount applied by the voucher. For percentage discounts, a value of 10 represents a 10% discount. For points_redemption, it indicates the fixed amount of points to be redeemed e.g. 10 equals 10 points

number
required

Minimum rate to apply the discount voucher in the voucher currency. e.g. a minimum_spend of USD$100 will only apply for bookings with a price USD$100 or more

number
required

Maximum discount amount that can be applied using the voucher in voucher currency. e.g. a with a maximum_discount_amount of 50 in USD, will discount from 0 to USD$50

string
required

Currency in which the discount is offered

date
required

Date from which the voucher becomes valid

date
required

Date until which the voucher remains valid

number
required

Maximum number of times the voucher can be redeemed

string
required

Current status of the voucher (e.g., active, inactive)

string

The unique identifier of the guest associated with the voucher

string

A brief description of the voucher, detailing its purpose or offer

string

Terms and conditions associated with the voucher

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json