Airbnb API - Room Settings

Access and overview

This article explains the settings on the Room Settings page in the Airbnb API mapping process. On this page, users can edit room configuration details such as discounts, pricing rules, and availability rules.

The Room Settings page will be displayed when following Step 3: Set Up/Edit Room Configuration Details in the Airbnb API connection process:

The Room Settings page

Once users click to configure a listing, the following items/settings will be available. To access the Settings page, click on the corresponding View/Edit button next to each item. Continue reading below for more details.

Price Settings

General

    • Listing Currency: The currency chosen here must match the currency you want your rates to be sent in.
    • Rates (Base Price): Rates are controlled by the Cloudbeds PMS calendar. Any dates without a rate entered in Cloudbeds PMS will default to this rate.
    • Number of guests included in this price: (Only for private rooms) add the maximum number of guests included in this rate
    • Extra Guest Fee per night: (Only for private rooms) add the extra guest fee you will charge per night. For Private rooms: Add (if applicable) this extra fee in a fixed amount per night.
      • This amount will be added to the base price once the reservation is created with more guests than the maximum number of guests included in this price.
      • For example, 2 guests are included in the base rate of $100, and the Extra Person fee is $20. If a person simulates a reservation in Airbnb with 3 guests, they will see a total of $120/night. 

Fees

Select the fees that you need to apply and their amount. For some fees, you can select whether the fee is per booking or per person.

  • Cleaning fees: Add the details of your cleaning and linen fees and if they are charged per guest or reservation
  • Other fees: Add here extra fees applied to your property, including the Deposit Amount if you charge a deposit.
  • Pet fee: If you accept pets, add the extra fee here. In case the property does not accept pets, a small alert will be displayed at the bottom of the page, explaining that in case of adding a pet fee, your house rules will need to be updated.

Important

  • Airbnb will send the total amount, inclusive of fees (except guest and host service fees), to our system as room revenue. Therefore, these fees will not be included in your rate breakdown. As an alternative, you can set up inclusive fees for the Airbnb channel so that your reservation breakdowns will include these fees.
  • In Cloudbeds PMS, it is not possible to create an inclusive flat fee/tax per reservation/accommodation.
  • If any assistance is required with setting up your Airbnb fees, reach out to the Airbnb team.

 

Taxes
Airbnb may already collect taxes on your behalf, depending on your location. To avoid double-charging guests, click here for a full list of where Airbnb directly collects and remits taxes.

  • Click on Add to configure new taxes.
  • Click on the Pencil icon Pencil icon.png to edit your tax details.
  • Click on the X icon to delete a tax
     
Pricing rules and discounts
  • Early bird: This discount is an exclusive offer available only to those who book a room during a certain timeline, typically if a guest books very early before the check-in date.
  • Last-minute discount: Offer special discounts for reservations created x days before arrival.
  • Nightly pricing rules: Add or decrease the base rate pricing according to pre-defined rules in this field. For example, if there is a holiday that you want to increase by 6% of the pricing, you can add this rule here and add the corresponding dates.
  • Length of stay discount: Offer discounts to guests who stay longer than a few nights at your property.
  • Custom length of stay discount: Set up custom length of stay discounts based on the number of nights your guests stay.

To add a discount or pricing rule, simply click on the Add button in the corresponding price/rule category:

  • If you have multiple discounts configured of the same type, threshold and date but with different discount values, Airbnb will only apply one of the discounts.
  • Since Airbnb will only apply one of the discounts if you have multiple discounts configured of the same type but with different discount values, Cloudbeds PMS will apply the discount that results in the highest price. Check the examples below for more details.

Example 1
You have three discounts of the same type, threshold, and date:

  • Long-term Stay (nights) - more than 10 days - 20% for period x
  • Long-term Stay (nights) - more than 10 days - 10% for period x
  • Long-term Stay (nights) - more than 10 days - 24% for period x
  • Only the Long-term Stay (nights) discount - more than 10 days - 10% will be applied as it results in the highest price.

However, if different types of discounts are selected for the same date, they will apply to both.

Example 2

  • Long-term Stay (nights) - more than 10 days - 24% for period x
  • Early Bird discount - more than 20 days in advance - 15% for period x
  • Both discounts will be applied.

Example 3
The room rate is $100, and the available discounts of the same type are: 30% discount and 20% discount.

  • 30% discount results in a new room rate of $70
  • 20% discount results in a new room rate of $80
  • In this case, Cloudbeds PMS will send the rate of $80 to Airbnb (since it's the highest rate).
Additional Settings

In this section, users can select specific tasks/instructions for guests to do before they check out, such as returning keys or throwing trash away:

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.