Contacts API is now generally available

Use the new Contacts API to create, update or overwrite property contact details.

Modify a property's contact details

A property's physical address and other contact details are stored at property level. Use /ota/OTA_HotelDescriptiveContentNotif to modify contact details.

Before you start

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.

You need:

property ID

Request

HTTP request

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

Request body

Provide an OTA_HotelDescriptiveContentNotifRQ object in the request body.
The contact details are in a ContactInfos array.
HotelDescriptiveContent[@HotelDescriptiveContentNotifType="Overlay"] indicates that you are modifying an existing hotel. (See the warning about overlays above!)

Example:

<!-- WARNING: This request overlays existing objects. Copy/pasting may lead to loss of information. -->
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelDescriptiveContentNotifRQ
  xmlns="http://www.opentravel.org/OTA/2003/05"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  PrimaryLangID="en-us"
  EchoToken="GUID"
  xsi:schemaLocation="http://www.opentravel.org/2014B/OTA_HotelDescriptiveContentNotifRQ.xsd"
  id="OTA2014B"
  Version="8.0"
  Target="Production">
  <HotelDescriptiveContents>
    <HotelDescriptiveContent
      HotelCode="{PropertyID}"
      LanguageCode="en"
      HotelDescriptiveContentNotifType="Overlay">
      <ContactInfos>
        <ContactInfo ContactProfileType="general">
          <Names>
            <Name Language="en">
              <GivenName>Peter</GivenName>
              <Surname>Griffin</Surname>
            </Name>
          </Names>          
          <Emails>
            <Email>noreply@booking.com</Email>
          </Emails>
          <Phones>
            <Phone PhoneNumber="+31612345678" PhoneTechType="1" />
          </Phones>
        </ContactInfo>
        <ContactInfo ContactProfileType="invoices">
          <Names>
            <Name Language="en">
              <GivenName>Erika</GivenName>
              <Surname>Mustermann</Surname>
            </Name>
          </Names>
          <Addresses>
            <Address>
              <AddressLine>Herengracht 597</AddressLine>
              <CityName>Amsterdam</CityName>
              <PostalCode>1017 CE</PostalCode>
              <StateProv StateCode="NH" />
              <CountryName>NL</CountryName>
            </Address>
          </Addresses>          
          <Phones>
            <Phone PhoneNumber="+31207777777" PhoneTechType="1" Extension="30" />
          </Phones>
        </ContactInfo>
      </ContactInfos>
    </HotelDescriptiveContent>
  </HotelDescriptiveContents>
</OTA_HotelDescriptiveContentNotifRQ>

Response

The response contains an OTA_HotelDescriptiveContentNotifRS object:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelDescriptiveContentNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_HotelDescriptiveContentNotifRS.xsd" TimeStamp="2015-07-31T12:36:23-00:00" Target="Production" Version="3.000">
<Success />
</OTA_HotelDescriptiveContentNotifRS>
<!-- RUID: [UmFuZGetc] -->