Property Settings API

Create property settings

Changed on Nov 11, 2026

Creates or updates the settings of a property. The request accepts settings in groups. All groups are optional, but some fields in a group are required when you send that group. You can send one or more groups in a request. If a field is invalid or a setting conflicts with the property's details, for example a curfew that overlaps the check-in or check-out times, the whole request is rejected with HTTP 400. Otherwise, each group is processed separately, and the response reports success per group. You must create the property before you can add settings. To set cancellation and prepayment policies, use the Policies API.

post/properties/{propertyId}/settings

Request

Base URL
https://supply-xml.booking.com/property-api
Auth
HTTP bearer
TypeScript
https://skmtc.dev/booking/apis/property-api/docs/properties/:propertyId/settings/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

propertyIdinteger required

The unique ID of the property to create or update the settings for.

Request body

land_registration_numbersstring[]

Land registration numbers of the property, also known as cadastral numbers. Properties in EU countries, excluding Spain, must provide them to comply with the EU DAC7 tax legislation.

Response

Property settings created or updated successfully.

dataobject

Contains the processing result for each group of settings in the request.

Example response

{
  "data": {
    "property_setting_1": {
      "success": true
    },
    "property_setting_2": {
      "success": true
    }
  }
}

Changes

Nov 11, 2026414e7c0af4ac Revision changes
- breaking
  added to the request property allOf list
- breaking
  added to the request property allOf list
- breaking
  added to the request property allOf list
- breaking
  added to the request property allOf list
- breaking
  added to the request property allOf list
- breaking
  added to the request property allOf list
- breaking
  added to the request property allOf list
- breaking
  added to the request property allOf list
- breaking
  added to the request property allOf list
- breaking
  added to the request property allOf list
- breaking
  added to the request property allOf list
- breaking
  added to the request property allOf list
- breaking
  the request property type changed from object to no type
- breaking
  the request property type changed from object to no type
- breaking
  the request property type changed from object to no type
- breaking
  the request property type changed from object to no type
- breaking
  the request property type changed from object to no type
- breaking
  the request property type changed from object to no type
- breaking
  the request property type changed from object to no type
- breaking
  the request property type changed from object to no type
- breaking
  the request property type changed from object to no type
- breaking
  the request property type changed from object to no type
- breaking
  the request property type changed from object to no type
- breaking
  the request property type changed from object to no type
- breaking
  the // response's property type changed from object to no type for status
- breaking
  the // response's property type changed from object to no type for status
- breaking
  the response's property type changed from object to no type for status
- breaking
  the // response's property type changed from object to no type for status
- breaking
  the // response's property type changed from object to no type for status
- 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 /
- 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 /
- 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 /
- 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 /
- 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 /
- 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 /
- 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 /
- 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 /
- 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 /
- 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 /
- warning
  removed the optional property / from the response with the status
- info
  added to the // response property allOf list for the response status
- info
  added to the // response property allOf list for the response status
- info
  added to the // response property allOf list for the response status
- info
  added to the // response property allOf list for the response status
- info
  added to the response property allOf list for the response status
Oct 27, 2026f418b903185a Revision changes
- breaking
  request property // was restricted to a list of enum values
- breaking
  removed the enum value STANDARD of the request property /
- info
  the request property default value 90 was added
- info
  added the new 45.00 enum value to the request property //
- info
  added the new 60.00 enum value to the request property //
- info
  added the new 75.00 enum value to the request property //
- info
  added the new 90.00 enum value to the request property //
- info
  added the new Standard enum value to the request property /

Operation history (3 revisions)