Create Property

The endpoint allows users to create a new property by providing essential details, including the property name, category, physical location, check-in and check-out times, and other relevant information. Upon successful processing of the request, the endpoint will provide a unique property ID for the newly created property.

---

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/bdc/property/create

Attributes

---

hotel_id alphanumeric (Required)

The unique property ID as assigned by the provider upon creation of the property.

---

legal_entity_id string (Required)

The unique id for the legal entity associated with the hotel.

Only allowed for new properties.

---

position object

Object containing geographical coordinates of the property.

latitude double (Required)

Latitude coordinates of the hotel location.

longitude double (Required)

Longitude coordinates of the hotel location.

---

check_in object

Object containing check-in times.

Specify 24-hour check-in by using 00:00 for both from and until.

from enumerated string (Required)

Start time for check-in (required).

Accepted values follow the Booking.com Check-In / Check-Out Times format.

until enumerated string (Optional)

End time for check-in.

Accepted values follow the Booking.com Check-In / Check-Out Times format.

---

check_out object

Object containing check-out times.

from enumerated string (Optional)

Start time for check-out (optional).

Accepted values follow the Booking.com Check-In / Check-Out Times format.

until enumerated string (Required)

End time for check-out (required if check_out > from is specified).

Accepted values follow the Booking.com Check-In / Check-Out Times format.

---

property_name string (Required)

Name of the hotel property on Booking.com.

Does not support using CJK Unified Ideographs.

---

property_category integer (Required)

Category identifier for the hotel.

For a list of supported property class type codes, see Property Class Type Code.

---

primary_language enumerated string (Optional)

Main preferred language spoken at the property.

Default: en-gb.

For a list of supported language codes, see Booking.com Language Code table.

---

languages_spoken array of enumerated strings (Optional)

Array of languages spoken at the property.

Can contain multiple Language elements.

For a list of supported language codes, see Booking.com Language Code table.

---

room_count integer (Required)

Number of sellable units/rooms available at the hotel.

A "sellable unit" is the smallest possible space that a guest can book at the property.

In a property with 200 rooms, each room is a sellable unit, and the value would be 200.

In a holiday home, guests must typically book the home in its entirety, making the value 1.

---

floor_count integer (Optional)

The total number of floors in the building/hotel, excluding the underground floors.

Max value can be 200.

---

stars string (Optional)

The number of stars, rating of the hotel.

• Accepts values: 0–5.

• Starting from 1, accepts values in increments of .5.

• Some countries don't use star ratings.

• To see whether your property belongs to a Hotel property type, see the property class type table.

---

target enumerated string (Required)

Specifies whether it is a test or production-ready property.

Accepts the following values:

• test

• production

---

provider_property_id string (Optional)

Identifier for the property provider.

Recommended for new properties. For example, the provider's internal ID.

Can contain a maximum of 16 characters.

---

currency_code enumerated string (Optional)

The Booking.com defined currency for the property.

In select countries a currency other than the default can be selected.

For more details see the information the currency documentation.

---

physical_address object (Required)

Object containing address details.

city_name string (Required)

City where the hotel is located.

Does not support using CJK Unified Ideographs.

country_code enumerated string (Required)

ISO code for the country (IN for India).

For more information on how to retrieve the country code details, see xml/countries endpoint.

postal_code string (Optional)

Postal code of the hotel's location.

Make sure the zip code (postal_code) is relevant to the country specified in the country_code.

address_line string (Required)

Detailed address of the hotel.

Does not support using CJK Unified Ideographs.

Should not contain abbreviations (such as "Rd." for "Road") and should not exceed 255 characters.

display_address boolean (Optional)

Boolean indicating if the address should be displayed.

- true : Shows the full address to the guest. - false : Hides the full address from the guest.

---

translations object

Object for multilingual support. Specifies the non-English translations of the physical address.

city_name string (Required)

Translated city name.

address_line string (Required)

Translated address line.

Should not contain abbreviations (such as "Rd." for "Road") and should not exceed 255 characters.

language_code enumerated string (Required)

Language code for translation.

Used for non-English translations.

For a list of supported language codes, see Booking.com Language Code table.

property_name enumerated string (Required)

Name of the hotel property (translated) on Booking.com.

Does not support using CJK Unified Ideographs

---

Sample Request

{
    "hotel_id": "new1",
    "legal_entity_id": "78775",
    "position": {
        "latitude": -36.8485,
        "longitude": 174.7633
    },
    "check_in": {
        "from": "12:30",
        "until": "13:00"
    },
    "check_out": {
        "from": "10:00",
        "until": "10:30"
    },
    "property_name": "TP TEST hotel NZ",
    "property_category": 30,
    "primary_language": "en-nz",
    "languages_spoken": [
        "en-nz"
    ],
    "room_count": 8,
    "floor_count": 1,
    "stars": "4",
    "target": "test",
    "provider_property_id": "test",
    "currency_code": "NZD",
    "physical_address": {
        "city_name": "Auckland",
        "country_code": "NZ",
        "postal_code": "1010",
        "address_line": "123 Queen Street",
        "display_address": true
    },
    "translations": {
        "city_name": "t1",
        "address_line": "t2",
        "language_code": "ca",
        "property_name": "New"
    }
}

---

Response

Sample Success Response

{
    "Status": "Success",
    
    "Data": {
        "property_id": 12905777
    },
    "Message": "Property created successfully"
}

Error

Any errors encountered from the Su side will be contained within an "Error" object.

Sample Error Response (Validation Error Response)

{
    "Status": "Fail",
    "Errors": [
        {
            "Code": "591",
            "ShortText": "position is invalid or not found!"
        },
        {
            "Code": "592",
            "ShortText": "position - latitude is invalid or not found!"
        },
        {
            "Code": "593",
            "ShortText": "position - longitude is invalid or not found!"
        }
    ],
    "Message": ""
}

Sample Error Response (Booking.com Error Response)

{
    "Status": "Fail",
    "Errors": [],
    "Message": "Invalid value - Legal entity 12855361 does not have a valid contract and is not allowed to create properties "
}

Response Body Elements

Status string

The status of the response.

---

Data object

The response data, the root element.

property_id string

Specifies the property ID that was created.

---

Message string

The message in the response.