# Create property Endpoint: POST /properties Version: 1.0 ## Header parameters: - `Accept-Version` (string) ## Request fields (application/json): - `translations` (array) Non-English translations of the physical address [Current Documentation](/connectivity/docs/api-reference/addresses/) DataMapping: Addresses - `translations.city_name` (string, required) The name of the city, town, or village. [Current Documentation: CityName](/connectivity/docs/api-reference/address/) DataMapping: ContactInfo/Addresses/CityName - `translations.address_line` (string, required) The full street name and number. Should not contain abbreviations (such as "Rd." for "Road") and should not exceed 255 characters. [Current Documentation: AddressLine](/connectivity/docs/api-reference/address/) DataMapping: ContactInfo/Addresses/AddressLine - `translations.language_code` (string, required) Specifies the language of this set of address details. Used for non-English translations As defined by BCL table in docs [Current Documentation](/connectivity/docs/api-reference/address/) DataMapping: Language - `translations.property_name` (string, required) Non-english name [Current Documentation](/connectivity/docs/api-reference/address/) DataMapping: Language - `position` (object, required) [Current Documentation](/connectivity/docs/api-reference/position/) Data Mapping: Position - `position.latitude` (number, required) Property's latitude. Validation: Must be between -90 and 90 - `position.longitude` (number, required) Property's longitude. Validation: Must be between -180 and 180 - `check_in` (object, required) [Current Documentation](/connectivity/docs/api-reference/policyinfo/) Data Mapping: PolicyInfo/CheckInTime/CheckOutTime - `check_in.from` (string) Validation: Specified via the format HH:MM, where HH can be 00 to 24 and MM can be 00 or 30 Required for check-in, optional for check-out 24-hour check-in/check-out can be specified using 00:00 as both from and to - `check_in.until` (string) Validation: Specified via the format HH:MM, where HH can be 00 to 24 and MM can be 00 or 30 Optional for check-in. If check-out passed, required. 24-hour check-in/check-out can be specified using 00:00 as both from and to - `check_out` (object) [Current Documentation](/connectivity/docs/api-reference/policyinfo/) Data Mapping: PolicyInfo/CheckInTime/CheckOutTime - `check_out.from` (string) Validation: Specified via the format HH:MM, where HH can be 00 to 24 and MM can be 00 or 30 Required for check-in, optional for check-out 24-hour check-in/check-out can be specified using 00:00 as both from and to - `check_out.until` (string) Validation: Specified via the format HH:MM, where HH can be 00 to 24 and MM can be 00 or 30 Optional for check-in. If check-out passed, required. 24-hour check-in/check-out can be specified using 00:00 as both from and to - `property_name` (string, 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](/connectivity/docs/api-reference/hoteldescriptivecontent/) DataMapping: HotelName - `property_category` (integer) The Property Class Type Code for the property. Validation: One of [(PCT) Property Class Type Codes (OTA 2014B)](/connectivity/docs/codes-pct/). During creation, either property_category or booking_property_category are required. [Current Documentation](/connectivity/docs/api-reference/hotelcategory/) DataMapping: HotelCategory/Code - `booking_property_category` (integer) 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_language` (string) 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](/connectivity/docs/codes-bcl/) Default: en-gb [Current Documentation](/connectivity/docs/api-reference/hoteldescriptivecontent/) DataMapping: LanguageCode - `languages_spoken` (array) The languages spoken by staff. Validation: One of [Booking.com Language Code](/connectivity/docs/codes-bcl/) DataMapping: HotelInfo->Languages - `room_count` (integer, required) The number of sellable units the property offers. DataMapping: GuestRoomInfo->Quantity - `floor_count` (integer) Total number of floors the building has (excl. underground floors). Validation: Max value of 200 DataMapping: TotalNumberOfFloors->Number - `provider_property_id` (string) 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_code` (string) 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](/connectivity/docs/api-reference/hoteldescriptivecontent/) Data Mapping: currencyCode - `stars` (string) 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` (string, required) Specifies whether the request is to create a test property or a real property. Validation: String value of production or test DataMapping: Target Enum: "test", "production" - `physical_address` (object, required) - `physical_address.city_name` (string, required) The name of the city, town, or village. Validation: We do not allow CJK Unified Ideographs [Current Documentation: CityName](/connectivity/docs/api-reference/address/) DataMapping: ContactInfo/Addresses/CityName - `physical_address.country_code` (string, required) [Two-letter country code](/connectivity/docs/b_xml-countries/). Validation: One of [Two-letter country code](/connectivity/docs/b_xml-countries/) Country codes follow ISO 3166 [Current Documentation: CountryName](/connectivity/docs/api-reference/address/) DataMapping: ContactInfo/Addresses/CountryName - `physical_address.postal_code` (string) Postal/zip code. Validation: We validate against country specific post code formats. [Current Documentation: PostalCode](/connectivity/docs/api-reference/address/) DataMapping: ContactInfo/Addresses/PostalCode - `physical_address.address_line` (string, required) The full street name and number. Validations: Minimum 1 at most 255 characters. We also do not allow CJK Unified Ideographs. Should not contain abbreviations (such as "Rd." for "Road") and should not exceed 255 characters. [Current Documentation: AddressLine](/connectivity/docs/api-reference/address/) DataMapping: ContactInfo/Addresses/AddressLine - `physical_address.display_address` (boolean) Specifies whether to hide the address details. Defaults to true. [Current Documentation: HiddenAddress](/connectivity/docs/api-reference/hidden-address/) DataMapping: ContactInfo/HiddenAddress/ShouldHideAddress - `legal_entity_id` (integer, required) The leid for the property. [Current Documentation](/connectivity/docs/api-reference/companyname/) DataMapping: HotelInfo/OwnershipManagementInfos/OwnershipManagementInfo/CompanyName/Code ## Response default fields (application/json): - `data` (object) - `data.property_id` (integer) The Booking.com property ID, returned on creation of the property. [Current Documentation](/connectivity/docs/api-reference/hoteldescriptivecontent/) Data Mapping: HotelCode - `warnings` (array) - `warnings.message` (string) - `warnings.code` (integer) - `warnings.details` (object) - `warnings.description` (string) - `errors` (array) - `errors.message` (string) - `errors.code` (integer) - `errors.details` (object) - `errors.description` (string) - `meta` (object) - `meta.ruid` (string)