Creating a Mobile Rate
Creating a Mobile Rate
Use a mobile rate to offer a discounted price to guests who book through the Booking.com Android or iOS mobile app, or from a mobile phone or tablet browser.
Attributes
hotel_id string (Required)
Specifies the required node hotel_id contains the IT provider's hotel id for which the provider wishes to add promotion.
channel_hotel_id string (Required)
Specifies the unique hotel ID used in the external distribution channel or PMS (Property Management System).
name string (Required)
The name of the promotion. This name is only for you: it does not appear on Booking.com.
Must be 255 characters or less. This includes spaces.
type string (Required)
The type of promotion.
Should be mobile_rate for Mobile rate.
target_channel string (Optional)
The platform(s) where the customer can book the promotion.
For Mobile rates, it should be all.
Accepts: app, all.
'all' means app + mobile browser + tablet browser. For example, all includes guests who book through the Booking.com website using their mobile browser.
min_stay_through integer (Optional)
The minimum number of nights a guest must stay to be eligible for the promotion.
Accepts: 1–30.
discount object (Required)
Contains discount configuration details for the promotion.
value number (Required)
The discount percentage applied to the promotion.
Accepts: 10–80. You can't discount less than 10% or more than 80%.
stay_date object (Required)
The range of dates during which guests must stay at the property to receive the promotion
excluded_dates array[string] (YYYY-MM-DD) (Optional)
The date range the promotion does not apply.
early_booker integer (Required)
Defines the minimum number of days in advance a booking must be made to qualify for the promotion.
Accepts: 1–365.
parent_rates array[integer] (Required)
List of parent rate plan IDs to which the promotion applies. Each value represents a unique rate plan identifier.
Sample Request
Response
Success Response - Body Elements
Status string
Indicates the result of the API call.
Will be "Success" for successful operations.
Message string
A message receives within the response body. This will generally be an empty string if no additional information is needed.
Ruid string
Specifies the unique request ID.
Data object
An object containing data related to the successful promotion creation. This typically includes identifiers for the created promotions.
promotion_id string
The newly created promotion ID.
Errors Response - Body Elements
Errors Response - Body Elements
Status string
Indicates the result of the API call.
"Fail" – The request was not processed successfully due to validation errors or other issues.
Errors array[object]
A list of error objects providing detailed information about one or more issues encountered during request processing. This field may be empty if the error is conveyed through the Message field.
Code string
A unique error code representing the specific type of validation or processing error.
ShortText string
A brief, human-readable description of the error. Typically explains what went wrong and may include accepted values or constraints.
Message string
A descriptive error message summarizing the failure.
Ruid string
A unique request identifier generated for tracking and debugging purposes. This value should be provided when contacting support for issue investigation.
Last updated
Was this helpful?