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

Next steps