# Create property settings

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](/connectivity/docs/policies-api/policies-overview/).

Endpoint: POST /properties/{propertyId}/settings
Version: 1.0
Security: BearerAuth

## Security:

  - `BearerAuth` (unknown)
    http bearer JWT

## Path parameters:

  - `propertyId` (integer, required)
    The unique ID of the property to create or update the settings for.

## Request fields (application/json):

  - `property_settings` (object)
    Contains multiple settings related to the property.

  - `property_settings.require_cvc` (boolean)
    Specify whether guest needs to provide CVC for booking.

  - `property_settings.curfew` (object)
    Contains curfew settings for the property. Curfew start and end can't overlap with the property's check-in and check-out times.

  - `property_settings.curfew.enabled` (boolean)
    Specifies whether the property has curfew time enabled.

  - `property_settings.curfew.start` (string)
    Curfew start time in HH:MM format. Minutes must be 00 or 30. Start and end times must differ.

  - `property_settings.curfew.end` (string)
    Curfew end time in HH:MM format. Minutes must be 00 or 30. Start and end times must differ.

  - `property_settings.require_booker_address` (boolean)
    Specifies whether guests must provide an address.

  - `property_settings.require_booker_phone_number` (boolean)
    Specifies whether guests must provide a contact telephone number.

  - `property_settings.age_restriction` (object)
    Contains whether there is an age limit to check in.

  - `property_settings.age_restriction.enabled` (boolean)
    Specifies whether age restriction is enabled.

  - `property_settings.age_restriction.min` (integer)
    Specifies the minimum allowed age for guests to check in. Allowed age range: 18 to 99. Required if `enabled` is `true`.

  - `property_settings.age_restriction.max` (integer)
    Specifies the maximum allowed age for guests to check in. Allowed values: 0 to 99. `0` removes the maximum age limit. Required if `enabled` is `true`.

  - `property_settings.auto_replenish` (boolean)
    Specify if property enabled to auto-replenish hotel's inventory after cancellations

  - `property_settings.replenish_closed_rooms` (boolean)
    Reopen closed rooms after a cancellation with the rooms to.

  - `property_settings.long_stay` (object)
    Contains whether the property accepts stays longer than 30 nights.

  - `property_settings.long_stay.enabled` (boolean)
    Specifies whether the property has the long stay option enabled.

  - `property_settings.long_stay.max_length_of_stay` (integer)
    Maximum length of stay in days. Accepted values are 45, 60, 75, and 90. Defaults to 90 when long stay is enabled.
    Enum: "45", "60", "75", "90"

  - `property_settings.pricing_type` (string)
    Specifies the pricing type for the product. Values are not case-sensitive.
    Enum: "Standard", "LOS", "OBP"

  - `property_settings.allow_smoking` (boolean)
    Specifies whether properties allow smoking option.

  - `property_settings.view_cc_details` (boolean)
    Specify whether trusted properties can view the guest's credit card details

  - `pets` (object)
    Contains settings related to pets policy.

  - `pets.pets_allowed` (string, required)
    Specifies pets allowed option for the properties.
    Enum: "PETS_NOT_ALLOWED", "PETS_ALLOWED", "PETS_ALLOWED_ON_REQUEST"

  - `pets.pets_price_type` (string)
    Specifies pets price type option for the properties.
    Enum: "FREE", "CHARGES_MAY_APPLY"

  - `damage_policy` (object)
    Contains settings related to damage policy.

  - `damage_policy.amount` (number)
    Amount for Damages

  - `damage_policy.currency` (string)
    Currency used for Damages. We will use the property's default currency if not provided

  - `damage_policy.policy_type` (string, required)
    Policy Type for Damages
    Enum: "NONE", "HANDLED_BY_PROPERTY", "HANDLED_BY_BOOKING_COM"

  - `damage_policy.damage_programme_terms_agreed` (boolean)
    Specifies if the partner agrees to the terms (applicable for damage programme)

  - `damage_policy.collection_mode` (string)
    Specifies how you wish to collect the deposit (applicable for damage deposit)
    Enum: "CASH", "CREDIT_CARD", "PAYPAL", "BANK_TRANSFER", "OTHER"

  - `damage_policy.collection_when` (string)
    Specifies when you would collect the deposit (applicable for damage deposit)
    Enum: "ON_ARRIVAL", "SEVEN_DAYS_BEFORE_ARRIVAL", "FOURTEEN_DAYS_BEFORE_ARRIVAL"

  - `damage_policy.return_mode` (string)
    Specifies how you would return the deposit (applicable for damage deposit)
    Enum: "CASH", "CREDIT_CARD", "PAYPAL", "BANK_TRANSFER", "OTHER"

  - `damage_policy.return_when` (string)
    Specifies how you would return the deposit (applicable for damage deposit)
    Enum: "ON_CHECKOUT", "WITHIN_7_DAYS", "WITHIN_14_DAYS"

  - `standard_phrases` (array)
    Contains settings related to standard phrases.

  - `standard_phrases.name` (string, required)
    AccomodationTax and AccommodationTax are both accepted and refer to the same phrase. GET responses return AccomodationTax.
    Enum: "GuestIdentification", "InformArrivalTime", "PayBeforeStay", "TattooRestriction", "AccomodationTax", "AccommodationTax", "IsraeliCitizensVat", "RequireInvoice", "EarlyDeparture", "PedestrianZoneOnly", "LimitedParking", "AccessByUnpavedRoad", "OnsiteFunctions", "NoHenStagParty", "ResidentialArea", "BusyArea", "HalfBoardNoDrinks", "NoPublicTransport", "WaterCrisis", "RussiaAntiHostelRegulations", "Covid19BodyTempCheck", "Covid19RestrictionOfGuests", "Covid19NoSelfQuarantine", "Covid19ExtraCleaning", "Covid19ReducedFoodServices", "Covid19OnlyEssentialTravellers", "Covid19ShuttleSuspended", "Covid19ReducedServices", "Covid19ReducedHoursOfService", "Covid19ExtraDocumentation", "Covid19ReducedFacilities", "Covid19PhysicalDistance", "Covid19LocalGuidelinesFollowed", "Covid19FaceMaskMandatory", "Covid19QuarantineNotAllowed", "Covid19NoChargePCRTest", "Covid19NoCostExtension", "Covid19MedicalMonitoring", "Covid19NegativeRequired", "Covid19AtChargePCRTest", "Covid19InsurancePCRTest", "Covid19VaccinationNegativeTestCheckIn", "Covid19VaccinationNegativeTestRecoveryCheckIn", "Covid19VaccinationRecoveryCheckIn", "Covid19NegativeTestRecoveryCheckIn", "Covid19VaccinationCheckIn", "Covid19RecoveryCheckIn", "Covid19ProofRequired", "LongStayDisclaimerJapan", "GuestRentalAgreement", "GuestUnder18"

  - `standard_phrases.enabled` (boolean, required)
    Specifies whether the standard phrase is enabled. In a request, `false` removes the phrase.

  - `quiet_hours` (object)
    Contains settings related to quiet hours of the property.

  - `quiet_hours.enabled` (boolean, required)
    Specifies whether properties have quiet hours enabled

  - `quiet_hours.start` (string)
    Time when quiet hours start.

  - `quiet_hours.end` (string)
    Time when quiet hours ends.

  - `renovation` (object)
    Contains settings related to renovation dates.

  - `renovation.enabled` (boolean, required)
    Specifies whether renovation dates are enabled

  - `renovation.start` (string)
    Date when renovation start

  - `renovation.end` (string)
    Date when renovation until.

  - `bed_linen_policy` (object)
    Contains renting details for bed linens and towels, when they are not included in the room rate. Guests can rent them at the property for an additional charge or bring their own.

  - `bed_linen_policy.enabled` (boolean, required)
    Specifies whether the option to rent bed linen is enabled.

  - `bed_linen_policy.amount` (number)
    Specifies the cost of renting bed linens and towels, in the property's default currency. Required if `enabled` is `true`.

  - `accepted_payment_types` (object)
    Contains settings related to payment methods.

  - `accepted_payment_types.codes` (array)
    Specifies the list of supported payment methods. For the full list, see [Booking.com Payment Type Codes](/connectivity/docs/codes-bcpt/). Code `45` (Cash) is deprecated; use code `18` instead.

  - `french_tax_details` (object)
    Contains settings related to tax details. Only applicable for France, Martinique, Guadeloupe, French Guiana, Reunion and Mayotte.

  - `french_tax_details.category_id` (string)
    Contains a number - city tax category ID. You can retrieve available categories using the /xml/citytaxcategory call.

  - `french_tax_details.nature_id` (string)
    Contains a number - nature category ID. You can retrieve available categories using /xml/citytaxcategory call.

  - `french_tax_details.declare_revenue` (boolean, required)
    Do you declare revenues as professional for direct tax purposes

  - `french_tax_details.has_vat` (boolean, required)
    Do you have a VAT registered for this activity?

  - `french_tax_details.registered_in_rcs` (boolean, required)
    Are you registered as a professional at the trade commercial register (Registre du Commerce et des Sociétés)?

  - `cancellation_exceptions` (object)
    Contains settings related to cancellation for non-refundable policies.

  - `cancellation_exceptions.grace_period` (object)
    Contains the grace period: free cancellation for a number of hours after booking.

  - `cancellation_exceptions.grace_period.enabled` (boolean, required)
    Specifies whether properties have grace period enabled

  - `cancellation_exceptions.grace_period.after_booking` (string)
    Grace period - amount of hours after booking when free cancellation is available.
    Enum: "HOURS_1", "HOURS_4", "HOURS_24"

  - `cancellation_exceptions.advance_cancellation` (object)
    Contains the advance cancellation: free cancellation up to a number of weeks before check-in.

  - `cancellation_exceptions.advance_cancellation.enabled` (boolean, required)
    Specifies whether properties have advance cancellation enabled

  - `cancellation_exceptions.advance_cancellation.before_check_in` (string)
    Amount of weeks before check-in when free cancellation is available
    Enum: "WEEKS_4", "WEEKS_8", "WEEKS_12"

  - `age_buckets` (array)
    An age bucket is a category for children prices that specifies the age range to which the eventual price applies to. You must at least create one, but can create up to four age buckets per property. Each age bucket exists of a minimum and maximum age, where the maximum age is inclusive. Ages must be from 0 to 17, and buckets must be contiguous: each bucket's min_age must equal the previous bucket's max_age plus 1.

  - `age_buckets.min_age` (integer, required)
    Specifies the minimum age for the age bucket.

  - `age_buckets.max_age` (integer, required)
    Specifies the maximum age for the age bucket.

  - `children_policies` (object)
    Contains whether a property accepts children, the minimum age children are welcome and additional rules for existing beds, extra beds or cribs.

  - `children_policies.allow_children` (boolean)
    Specifies whether the property admits adults and children, or only adults.

  - `children_policies.min_age` (integer)
    Specifies the minimum age that children are allowed (in case allow_children = true).

  - `children_policies.policy_rules` (array)
    Contains the price and rules for children staying in an existing bed, and the price for children staying in a crib or extra bed. Applies only when `allow_children` is `true`, except for `EXTRA_BED_FOR_ADULT`. Sending an empty array removes all rules.

  - `children_policies.policy_rules.rule_type` (string, required)
    Specifies the type of bed the rule applies to. The age allowance for `CRIB` is from 0 to 6.
    Enum: "EXISTING_BED", "EXTRA_BED", "CRIB", "EXTRA_BED_FOR_ADULT"

  - `children_policies.policy_rules.from_age` (integer)
    Specifies the minimum age for the rule to apply. In combination with `to_age`, it becomes an age range. Optional for `EXTRA_BED_FOR_ADULT`.

  - `children_policies.policy_rules.to_age` (integer)
    Specifies the maximum age for the rule to apply. Optional for `EXTRA_BED_FOR_ADULT`.

  - `children_policies.policy_rules.price_type` (string, required)
    Specifies whether the rule is free (`FREE`), a percentage of the adult price (`ADULT_PERCENTAGE`) or a fixed price (`FIXED`).
    Enum: "FIXED", "FREE", "ADULT_PERCENTAGE"

  - `children_policies.policy_rules.price_mode` (string, required)
    Specifies the unit of time on which the charge is calculated.
    Enum: "PER_STAY", "PER_NIGHT"

  - `children_policies.policy_rules.price` (number)
    If `price_type` is `FIXED`, specifies a fixed amount in the country's local currency. If `price_type` is `ADULT_PERCENTAGE`, specifies the percentage of the adult price to charge as the child price.

  - `booking_model` (object)
    Contains whether the property uses request to book or instant booking.

  - `booking_model.type` (string, required)
    Specifies the booking model of the property: request to book (`RTB`) or instant booking (`IB`). For more information, see the [eligibility criteria](/connectivity/docs/request-to-book/eligibility/).
    Enum: "IB", "RTB"

  - `invoice_settings` (object)
    Specifies the details of the company that owns or manages the property.

  - `invoice_settings.legal_name` (string)
    Specifies the legal name of the company.

  - `invoice_settings.contact_person` (string)
    Specifies the full name of the contact person. Required before the property can be set to open and bookable.

  - `invoice_settings.address` (string)
    Invoice address. Chinese, Japanese, and Korean characters are not accepted.

  - `invoice_settings.country_code` (string)
    Specifies the country code, as a valid ISO code. Required before the property can be set to open and bookable.

  - `invoice_settings.city` (string)
    Invoice city. Chinese, Japanese, and Korean characters are not accepted.

  - `invoice_settings.postal_code` (string)
    Specifies the postal or zip code.

  - `invoice_settings.state` (string)
    Specifies the state.

  - `invoice_settings.notification_channel` (string)
    The channel how company should be notified invoice related mails.
    Enum: "POSTAL_MAIL", "EMAIL"

  - `invoice_settings.brazil_tax_details` (object)
    Contains tax details for properties in Brazil, issued by the Brazilian tax authority and used for invoicing. Required before a property in Brazil can be set to open and bookable.

  - `invoice_settings.brazil_tax_details.tax_payer_number_type` (string, required)
    Specifies whether the identifying number belongs to a company or a private individual.
    Enum: "CNPJ", "CPF"

  - `invoice_settings.brazil_tax_details.tax_payer_number` (string, required)
    The identifying number. CNPJ = 14 digits. CPF = 11 digits.

  - `invoice_settings.brazil_tax_details.city_hall_id` (string, required)
    The 8-digit ID for the city hall which issued the CNPJ or CPF number

  - `invoice_settings.brazil_tax_details.email` (string, required)
    Specifies the email address of the invoice recipient.

  - `land_registration_numbers` (array)
    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.

## Request examples:

  - `Create all property settings` (unknown)
    Sets most setting groups in one request. `brazil_tax_details` applies only to properties in Brazil. `french_tax_details` is not included: the API rejects the whole request when the property is not in a location eligible for French city tax. `booking_model` is not included: you can change the booking model only for properties eligible for request to book.

  - `Set a renovation period and a damage policy` (unknown)

  - `Set a grace period and advance cancellation` (unknown)

  - `Enable long stays` (unknown)

  - `Set the pricing type` (unknown)

## Response 200:

  - `200` (unknown)
    Property settings created or updated successfully.

## Response 200 fields (application/json):

  - `data` (object)
    Contains the processing result for each group of settings in the request.
    Example: {"property_setting_1":{"success":true},"property_setting_2":{"success":true}}

  - `warnings` (array)
    Contains any warnings about the request.

  - `warnings.message` (string)
    Short summary of the warning or error, for example `Invalid value` or `Data not found`.

  - `warnings.code` (integer)
    Booking.com error code, for example 320 (Invalid value), 321 (Required field missing) or 635 (Data not found).

  - `warnings.details` (object)
    Additional information when available, such as the request fields the warning or error relates to (`fields`) or the values the field accepts.

  - `warnings.description` (string)
    Detailed explanation of the warning or error.

  - `errors` (array)
    Contains any errors about the request.

  - `meta` (object)
    Contains metadata about the response.

  - `meta.ruid` (string)
    Specifies the unique request ID. You can share this ID with Booking.com customer support when you run into an issue.

## Response 400:

  - `400` (unknown)
    Bad request. A field is unknown or invalid, or a setting conflicts with the property's details. The whole request is rejected.

## Response 400 fields (application/json):

  - `warnings` (array)

  - `warnings.message` (string)
    Short summary of the warning or error, for example `Invalid value` or `Data not found`.

  - `warnings.code` (integer)
    Booking.com error code, for example 320 (Invalid value), 321 (Required field missing) or 635 (Data not found).

  - `warnings.details` (object)
    Additional information when available, such as the request fields the warning or error relates to (`fields`) or the values the field accepts.

  - `warnings.description` (string)
    Detailed explanation of the warning or error.

  - `errors` (array)

  - `meta` (object)

  - `meta.ruid` (string)
    Specifies the unique request ID. You can share this ID with Booking.com customer support when you run into an issue.

## Response 200 examples:

  - `Create all property settings` (unknown)

  - `Set a renovation period and a damage policy` (unknown)

  - `Set a grace period and advance cancellation` (unknown)

  - `Enable long stays` (unknown)

  - `Set the pricing type` (unknown)

## Response 400 examples:

  - `Unknown field in the request body` (unknown)

  - `Curfew overlaps check-in or check-out times` (unknown)

  - `French tax details for a property outside France` (unknown)

