BObooking
Property Details API

Create property

Changed on

Creates a property with details such as the name, property category, physical location and check-in and check-out times, and returns the new property ID. In addition to the schema validations:

  • The latitude and longitude must be in the country specified in physical_address.country_code.
  • The postal code must be correct for the city and the country.
  • The property must not duplicate an existing production property. A duplicate is an exact match on the property name, address line, latitude and longitude. Test properties are not searched when checking for duplicates.
post/properties

Request

Headers

Accept-Versionstring

The API version to use. Currently supports the value 1.0.

Request body

property_namestring required

Specifies the name of the property on Booking.com. Validation: We do not allow CJK Unified Ideographs. Should be shorter than 255 characters. Must have at least 3 letters, one of which must be lower case. Must not have more than 5 numbers. Can't include punctuation, asterisks or symbols. Current Documentation DataMapping: HotelName

property_categoryinteger

The Property Class Type Code for the property. Validation: One of (PCT) Property Class Type Codes (OTA 2014B). During creation, either property_category or booking_property_category are required. Current Documentation DataMapping: HotelCategory/Code

booking_property_categoryinteger

The Booking.com code for property_category. Utilize the meta endpoint for valid values and their OTA mappings. Validation: During creation, either property_category or booking_property_category are required.

primary_languagestring

Specifies the language in which the property wants their Booking.com extranet content and communication (emails, notifications, ...) etc. Validation: One of Booking.com Language Code Default: en-gb Current Documentation DataMapping: LanguageCode

languages_spokenstring[]

The languages spoken by staff. Validation: One of Booking.com Language Code DataMapping: HotelInfo->Languages

room_countinteger required

The number of sellable units the property offers. DataMapping: GuestRoomInfo->Quantity

floor_countinteger

Total number of floors the building has (excl. underground floors). Validation: Max value of 200 DataMapping: TotalNumberOfFloors->Number

provider_property_idstring

An external id to be associated with the property (e.g. the providers internal id) Validation: Maximum length of 16 characters DataMapping: HotelInfo-ID

currency_codestring

Booking.com defines the currency for each property. In most cases this should not be passed as only one currency is allowed per country. Retrieve a list of all currency codes with /xml/currencies Validation: Must be allowed for property's country Current Documentation Data Mapping: currencyCode

starsstring

The number of stars a property has. Validation: String with values 0 through 5, optionally may include half stars for values 1 or greater (i.e. 0, 1, 1.5, 2, 2.5 ... 4, 4.5, 5) Default: 0 DataMapping: AffiliationInfo->Awards->Award

target'test' | 'production' required

Specifies whether the request is to create a test property or a real property. Validation: String value of production or test DataMapping: Target

legal_entity_idinteger required

The leid for the property. Current Documentation DataMapping: HotelInfo/OwnershipManagementInfos/OwnershipManagementInfo/CompanyName/Code

Response

Property created. The response contains the new property ID.

Changes

  • 414e7c0af4acRevision changes
    • breaking

      added to the request property allOf list

    • breaking

      the request property type changed from object to no type

    • warning

      changed the pattern of the request property from ^0(\.0)?|[1-4](\.[05])?|5(\.0)?$ to ^(0(\.0)?|[1-4](\.[05])?|5(\.0)?)$

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • info

      added the non-success response with the status

    • info

      added the success response with the status