---
title: "Update Airbnb Listing Price and Rules"
method: POST
path: "/listings/airbnb/price_and_rules"
tags: ["Listing Calendar"]
---

# Update Airbnb Listing Price and Rules

`POST /listings/airbnb/price_and_rules`

Update the listing-level pricing, fees, booking settings and availability rules of an Airbnb listing. <br><br>Unlike the calendar endpoints, this updates the listing's default settings (not a specific date range). Only the fields you provide are updated; omit a field to leave it unchanged. <br><br>This request is processed synchronously against Airbnb: a successful response means the changes were accepted by Airbnb.

## Request body

- object
  - `listing_id` string, required — The unique identifier for different channels. <br>For example, the listing id for Airbnb is the Airbnb listing id, and the listing id for Booking.com is the Booking.com room id - rateplan id.
  - `settings` object, required — The settings to update. All fields are optional; only the provided fields are updated.
    - `listing_currency` string — The listing currency code, e.g. `USD`.
    - `base_price` number — The default nightly price.
    - `weekend_price` number — The Friday and Saturday nightly price.
    - `security_deposit` number — The security deposit amount.
    - `cleaning_fee` number — The cleaning fee amount.
    - `short_term_cleaning_fee` number — The short-term cleaning fee amount.
    - `pet_fee` number, nullable — The pet fee amount. Mutually exclusive with `pet_fee_obj`.
    - `pet_fee_obj` object, nullable — The detailed pet fee. Mutually exclusive with `pet_fee`.
      - `amount` number
      - `charge_type` string
      - `charge_period` string
    - `extra_guest_fee` number — The fee charged per extra guest.
    - `early_bird_discount` object — Early bird discount. An object `{discount, days}` (or an array of such objects) where `discount` is a percentage (0-100) applied when booked at least `days` days ahead.
      - `discount` integer
      - `days` integer
    - `last_minute_discount` object — Last minute discount. An object `{discount, days}` (or an array of such objects) where `discount` is a percentage (0-100) applied when booked within `days` days of check-in.
      - `discount` integer
      - `days` integer
    - `long_term_discount` object — Long term discount. An object `{discount, days}` (or an array of such objects) where `discount` is a percentage (0-100) applied for stays of at least `days` nights.
      - `discount` integer
      - `days` integer
    - `check_in_start_time` unknown
    - `check_in_end_time` unknown
    - `check_out_before` integer — Check-out latest time, an integer hour 0-23.
    - `instant_booking` boolean — Whether instant booking is allowed.
    - `max_guests` integer — The number of guests included in the base price.
    - `minimum_stay` integer — The default minimum number of nights.
    - `maximum_stay` integer — The default maximum number of nights.
    - `advance_notice` integer — Booking lead time in hours.
    - `availability_window` integer — How far in advance (in days) the calendar is bookable.
    - `preparation_time` integer — Turnover/preparation days between reservations.
    - `days_of_week_check_in` integer[] — Days of week (0=Sunday ... 6=Saturday) on which check-in IS allowed; the remaining days are blocked.
    - `days_of_week_check_out` integer[] — Days of week (0=Sunday ... 6=Saturday) on which check-out IS allowed; the remaining days are blocked.
    - `allow_rtb_above_max_nights` boolean — Whether to allow request-to-book for stays exceeding the maximum nights.
    - `cancellation_policy` unknown
    - `long_term_cancellation_policy` unknown
    - `non_refundable_price_factor` number — The non-refundable discount percentage (0-100). Stored as a price factor of `(100 - value) / 100`.
    - `day_of_week_min_nights` unknown
    - `seasonal_min_stay` object[] — Seasonal minimum nights rules.
    - `new_listing_promotion` boolean — Whether to enable the Airbnb new listing promotion.
    - `high_rated_guest_discount` boolean — Whether to enable the Airbnb highly-rated guest discount (15% off for guests rated 4.8+ with at least 3 reviews).
    - `mobile_only_discount` boolean — Whether to enable the Airbnb mobile-only discount (10% off for guests booking via the Airbnb mobile app).

## Response `200`

The request has been successfully processed.

- CommonResponse
  - `request_id` string, required — Unique identifier for the request.
  - `error_code` integer, required — Numeric error code representing the status of the response. A value of `200` indicates success. <br> See the [Error Codes](/reference/error-manual#error-codes) section for more information.
  - `error_msg` string, required — Message detailing the status of the response.

---

[API](https://skmtc.net/hostex/apis/hostex-api.md) · [All operations](https://skmtc.net/hostex/apis/hostex-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hostex/hostex-api/revisions/a3fa555dee66/schema)