> For the complete documentation index, see [llms.txt](https://suissu.gitbook.io/su-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://suissu.gitbook.io/su-api-documentation/su-channel-manager/channel-content-api/airbnb-content-api/booking-settings/update-booking-settings.md).

# Update Booking Settings

This endpoint updates the Airbnb booking settings, including guest controls, check-in/out times, and cancellation policies, for a specified listing.

### <mark style="color:yellow;">Endpoint</mark>

<mark style="color:blue;">**`POST`**</mark>

<div align="left"><figure><img src="/files/lKCZjXkQwk8unXJYirMu" alt="" width="56"><figcaption></figcaption></figure></div>

{% code overflow="wrap" %}

```url
https://connect-sandbox.su-api.com/SUAPI/jservice/airbnb/bookingsetting/update
```

{% endcode %}

***

#### <mark style="color:yellow;">Header</mark>

```xml
-app-id: App Id
Authorization: Basic Authorization
Content-Type: application/json
```

<table><thead><tr><th width="185">Header</th><th width="85">Type</th><th width="101">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>app-id</code></td><td>string</td><td>Yes</td><td>Your application ID. Required for authentication.</td></tr><tr><td><code>Authorization</code></td><td>string</td><td>Yes</td><td>Your API key. for authorization. Required for authentication.</td></tr><tr><td><code>Content-Type</code></td><td>string</td><td>Yes</td><td>Must be set to <code>application/json</code>.</td></tr></tbody></table>

***

### <mark style="color:yellow;">Attributes</mark>

`hotelid` <mark style="color:orange;">**alphanumeric (Required)**</mark>&#x20;

Specifies the required node hotelid contains the IT provider's hotel id for which the provider wishes to add mapping information.

***

`channelhotelid` <mark style="color:orange;">**alphanumeric (Required)**</mark>&#x20;

Specifies the unique hotel ID used in the external distribution channel or PMS (Property Management System).&#x20;

***

`listingid` <mark style="color:orange;">**numeric (Required)**</mark>&#x20;

listing id of the property allocated by airbnb.&#x20;

***

`cancellation_policy_settings` <mark style="color:orange;">**object (Optional)**</mark>&#x20;

Contains the cancellation policy related settings.&#x20;

***

`cancellation_policy_category` <mark style="color:orange;">**enum (Optional)**</mark>&#x20;

Cancellation policy for the listings which can be set within booking settings. Obtain the required enum values through the Master Data API.&#x20;

***

`lts_cancellation_policy_id` <mark style="color:orange;">**enum (Optional)**</mark>&#x20;

Id of the cancellation policy. Allowed: CANCEL\_LONG\_TERM\_FAIR , CANCEL\_LONG\_TERM\_WITH\_GRACE\_PERIOD&#x20;

***

`eligible_cancellation_policies` <mark style="color:orange;">**array of strings (Optional)**</mark>&#x20;

array of supported or eligible cancellation policies.&#x20;

***

`non_refundable_price_factor` <mark style="color:orange;">**numeric (Optional)**</mark>&#x20;

[Non-refundable discount](https://developer.airbnb.com/homes/v2024.12.31/docs/booking-settings-api#non-refundable-price-factor) in percentage.&#x20;

***

`check_in_time_start` <mark style="color:orange;">**string (Optional)**</mark>&#x20;

Earliest time a guest can check in—must be an hour between “8”, “9”, “10”....“23”, or “FLEXIBLE”.&#x20;

***

`check_in_time_end` <mark style="color:orange;">**string (Optional)**</mark>&#x20;

Latest time a guest can check in—must be an hour between “9”, “10”, “11”....“27”, or "FLEXIBLE".&#x20;

***

&#x20;`check_out_time` <mark style="color:orange;">**string (Optional)**</mark>&#x20;

Latest time a guest can check out—must be an hour between 0 and 23.&#x20;

***

&#x20;`instant_booking_allowed_category` <mark style="color:orange;">**enum (Optional)**</mark>&#x20;

The category of guests that can create Instant Book reservations. Guests who don’t meet these requirements can send booking requests.&#x20;

Allowed: everyone, well\_reviewed\_guests&#x20;

***

&#x20;`instant_book_welcome_message` <mark style="color:orange;">**string (Optional)**</mark>&#x20;

Require guests to read and respond to a message before they confirm their reservation. Maximum 400 characters.&#x20;

***

`listing_expectations_for_guests` <mark style="color:orange;">**array of objects (Optional)**</mark>&#x20;

Expectations about the Host’s space that guests must agree to before booking.&#x20;

***

`type` <mark style="color:orange;">**enum (Required)**</mark>&#x20;

The type of the expectation the guests must agree to. Obtain the required enum values through the Master Data API.&#x20;

***

`added_details` <mark style="color:orange;">**string (Optional)**</mark>&#x20;

Additional details of the expectation. Max 300 characters.&#x20;

***

`guest_controls` <mark style="color:orange;">**object (Optional)**</mark>&#x20;

Rules regarding pets, children, events, and smoking in the Host's space.&#x20;

***

`allows_children_as_host` <mark style="color:orange;">**boolean (Required)**</mark>&#x20;

Specify if the listing is suitable for children (2-12 years).&#x20;

***

`allows_infants_as_host` <mark style="color:orange;">**boolean (Required)**</mark>&#x20;

Specify if the listing is suitable for infants (under 2 years).&#x20;

***

`children_not_allowed_details` <mark style="color:orange;">**string (Optional)**</mark>&#x20;

Provide details regarding why the property may not be safe for kids.&#x20;

***

`allows_smoking_as_host` <mark style="color:orange;">**boolean (Required)**</mark>&#x20;

Specify if smoking is allowed.&#x20;

***

`allows_pets_as_host` <mark style="color:orange;">**boolean (Required)**</mark>&#x20;

Specify if pets are allowed. \
Note: You must remove PASS\_THROUGH\_PET\_FEE type fees (If set) from the listing before you can disable allows\_pets\_as\_host.&#x20;

***

`pet_capacity` <mark style="color:orange;">**numeric (Optional)**</mark>&#x20;

Maximum number of pets that the listing can accommodate. If pets are allowed, the value must be an integer from 1 to 5—default is 5. If pets are not allowed, the value must be 0.&#x20;

***

`allows_events_as_host` <mark style="color:orange;">**boolean (Required)**</mark>&#x20;

Specify if parties or events are allowed.&#x20;

***

### <mark style="color:yellow;">Request</mark>

{% code overflow="wrap" %}

```json
{
  "hotelid": "SUTEST01",
  "channelhotelid": "511039958",
  "listingid": "1541919118065328804",
  "cancellation_policy_settings": {
    "cancellation_policy_category": "flexible",
    "lts_cancellation_policy_id": "CANCEL_LONG_TERM_WITH_GRACE_PERIOD",
    "non_refundable_price_factor": "",
    "eligible_cancellation_policies": [
      "flexible",
      "firm_14",
      "better_strict_with_grace_period",
      "super_strict_30",
      "super_strict_60",
      "moderate"
    ]
  },
  "check_in_time_start": "15",
  "check_in_time_end": "FLEXIBLE",
  "check_out_time": "11",
  "instant_booking_allowed_category": "everyone",
  "instant_book_welcome_message": "Welcome to our Beautiful resort",
  "listing_expectations_for_guests": [
    {
      "type": "requires_stairs",
      "added_details": ""
    },
    {
      "type": "limited_parking",
      "added_details": ""
    }
  ],
  "guest_controls": {
    "allows_children_as_host": true,
    "allows_infants_as_host": true,
    "children_not_allowed_details": "",
    "allows_smoking_as_host": false,
    "allows_pets_as_host": false,
    "pet_capacity": 0,
    "allows_events_as_host": false
  }
}
```

{% endcode %}

***

### <mark style="color:yellow;">Response</mark>

***

#### <mark style="color:green;">Success Response</mark>

{% code overflow="wrap" %}

```json
{
  "Status": "Success",
  "Data": {
    "booking_setting": {
      "guest_controls": {
        "allows_infants_as_host": true,
        "allows_events_as_host": false,
        "allows_children_as_host": true,
        "pet_capacity": 0,
        "allows_pets_as_host": false,
        "allows_smoking_as_host": false
      },
      "check_out_time": 11,
      "instant_book_welcome_message": "Welcome to our Beautiful resort",
      "cancellation_policy_settings": {
        "cancellation_policy_category": "flexible",
        "eligible_cancellation_policies": [
          "flexible",
          "firm_14",
          "better_strict_with_grace_period",
          "super_strict_30",
          "super_strict_60",
          "moderate"
        ],
        "lts_cancellation_policy_id": "CANCEL_LONG_TERM_WITH_GRACE_PERIOD"
      },
      "instant_booking_allowed_category": "everyone",
      "listing_expectations_for_guests": [
        {
          "type": "requires_stairs"
        },
        {
          "type": "limited_parking"
        }
      ],
      "check_in_time_start": "15",
      "check_in_time_end": "FLEXIBLE",
      "listing_id": "1541919118065328804"
    }
  },
  "Message": "Booking setting updated successfully"
}
```

{% endcode %}

***

#### <mark style="color:green;">Success Response - Body Elements</mark>&#x20;

***

`Data` <mark style="color:orange;">**object**</mark>

Contains the updated booking setting information returned by the API.

***

`booking_setting` <mark style="color:orange;">**object**</mark>

Holds all booking-related configuration for the listing.

***

`guest_controls` <mark style="color:orange;">**object**</mark>

Defines rules for which guests or activities are allowed at the property.

***

`allows_infants_as_host` <mark style="color:orange;">**boolean**</mark>

Indicates if infants are allowed at the property.

***

`allows_events_as_host` <mark style="color:orange;">**boolean**</mark>

Indicates if parties or events are allowed.

***

`allows_children_as_host` <mark style="color:orange;">**boolean**</mark>

Indicates if children are allowed.

***

`pet_capacity` <mark style="color:orange;">**integer**</mark>

Maximum number of pets allowed.

***

`allows_pets_as_host` <mark style="color:orange;">**boolean**</mark>

Indicates if pets are allowed at the property.

***

`allows_smoking_as_host` <mark style="color:orange;">**boolean**</mark>\
Indicates if smoking is allowed at the property.

***

`check_out_time` <mark style="color:orange;">**integer**</mark>

The designated check-out time for guests.

***

`instant_book_welcome_message` <mark style="color:orange;">**string**</mark>

Welcome message sent to guests for instant bookings.

***

`cancellation_policy_settings` <mark style="color:orange;">**object**</mark>

Contains cancellation policy configuration details.

***

`cancellation_policy_category` <mark style="color:orange;">**string**</mark>

The selected cancellation policy category.

***

`eligible_cancellation_policies` <mark style="color:orange;">**array**</mark>

List of available cancellation policies that can be applied.

***

`lts_cancellation_policy_id` <mark style="color:orange;">**string**</mark>

Long-term stay cancellation policy identifier.

***

`instant_booking_allowed_category` <mark style="color:orange;">**string**</mark>

Indicates who is allowed to instantly book the listing.

***

`listing_expectations_for_guests` <mark style="color:orange;">**array**</mark>

List of expectations that guests must agree to before booking.

***

`type` <mark style="color:orange;">**string**</mark>

Specifies the type of guest expectation.

***

`check_in_time_start` <mark style="color:orange;">**string**</mark>

Earliest time a guest can check in.

***

`check_in_time_end` <mark style="color:orange;">**string**</mark>

Latest time a guest can check in.

***

`listing_id` <mark style="color:orange;">**string**</mark>

Listing ID of the property.

***

`Message` <mark style="color:orange;">**string**</mark>

A descriptive message indicating successful update of booking settings.

***

#### <mark style="color:red;">Error Response</mark>

{% tabs %}
{% tab title="Error 1" %}

```json
{
  "Status": "Fail",
  "Errors": [
    {
      "Code": "981",
      "ShortText": "channelhotelid is not defined or invalid value"
    }
  ]
}
```

{% endtab %}

{% tab title="Error 2" %}

```json
{
  "Status": "Fail",
  "Errors": [],
  "Message": "You do not have permission to access this resource. "
}
```

{% endtab %}
{% endtabs %}

***

#### <mark style="color:red;">Error Response - Body Elements</mark>

`Status` <mark style="color:orange;">**string**</mark>

Indicates the result of the API call.&#x20;

{% hint style="info" %}
Will be always `"Fail"` in case of an error response.
{% endhint %}

***

`Errors` <mark style="color:orange;">**object**</mark>

The response error, the root element.

***

`Code` <mark style="color:orange;">**string**</mark>

Specific error code that helps identify the type of error.

{% hint style="info" %}
For example: `"400"` indicates a bad request.
{% endhint %}

***

`ShortText` <mark style="color:orange;">**string**</mark>

A short description of the error.

***

`Message` <mark style="color:orange;">**string**</mark>

The message in the response.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://suissu.gitbook.io/su-api-documentation/su-channel-manager/channel-content-api/airbnb-content-api/booking-settings/update-booking-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.