Modifying property name

Exercise caution while using the Overlay mode

Content API uses an overlay system. Every time you update an existing property, room type, or other object, the body of your request replaces whatever information was stored in our servers at that time. This means existing information may be deleted if you don't include it in your request.

To update an object without deleting information, make sure your request contains both the fields you want to update and those you want to keep the same. Copy/paste sample requests from this page at your own risk.

POST https://supply-xml.booking.com/hotels/ota/OTA_HotelDescriptiveContentNotif

The /ota/OTA_HotelDescriptiveContentNotif endpoint also enables you to change the property name, but only when property ownership (legal entity id) does not change. If the legal entity ID does change, you must follow the change of ownership process.

Major name change

If the name change is significant (major change), then all guests who booked a stay when the old name was still used receive an email informing them of the new property name.

When renaming a property, ensure that the name:

Has a length between 3 and 255 characters.
Does not contain a phone number (or no more than five consecutive numbers).
Only contains letters (any language), numbers, or the following symbols: ! # & ` ' " - ,
Is not all in uppercase.

Certain words are blacklisted

If a name is rejected, the property name could contain a blacklisted word. If you do not think this is the case, reach out to our Customer Support.

Header parameters

The following table lists the header parameters in the request:

Parameter	Description	Type	Required/Optional	Notes
`Authorization`	Machine account username and password	string	Required	Example: `Authorization: Basic {username:password}`

Body parameters

You can find the body parameters in the following table:

Element	Description	Type	Required/Optional	Notes
`OTA_HotelDescriptiveContentNotifRQ`	Contains the `Target` attribute, which specifies the request is for a real property (`Production`) or a test property (`Test`).	root element	required
: `HotelDescriptiveContents`	Contains the `HotelDescriptiveContent` elements.	array	required
:: `HotelDescriptiveContent`	Contains the following attributes: `HotelDescriptiveContentNotifType`: Specifies whether the request is meant to create a new property (`New`) or overlay an existing one (`Overlay`). Set it to `Overlay` to change the name. `HotelCode`: Specifies the unique property id. `HotelName`: Specifies the name of the property. Here you can change the name of the property.	object	required	The default value for `HotelDescriptiveContentNotifType` is `New`.

Request body example

You can find a request body example below:

<OTA_HotelDescriptiveContentNotifRQ Target="Production">
  <HotelDescriptiveContents>
    <HotelDescriptiveContent
      HotelDescriptiveContentNotifType="Overlay"
      HotelCode="12345"
      HotelName="The New Property Name">
    </HotelDescriptiveContent>
   </HotelDescriptiveContents>
</OTA_HotelDescriptiveContentNotifRQ>

Sample response

You can find a sample response below:

<OTA_HotelDescriptiveContentNotifRS Target="Production">
    <Success />
</OTA_HotelDescriptiveContentNotifRS>
<!-- RUID: [UmFuZG9t] -->

Response body

Element	Description	Type	Notes
`OTA_HotelDescriptiveContentNotifRS`	Contains the `Target` attribute, which specifies the response was for a real property (`Production`) or a test property (`Test`).	root element
: `Success`	Denotes the success of the request.	object