The Cloudbeds PMS has a new look! As we work to update our knowledgebase some steps in our articles might not match our new design. Click here for more details.

Airbnb API - Room Mapping Guidelines


While connecting Airbnb API, the mapping process may differ depending on the room setup that you have on Airbnb (if you have individual listings, room types, or shared dorms). Check in this article the instructions to map your room setup accordingly.

Choose the room setup scenario of your property:

1. Mapping individual Airbnb listings with individual Cloudbeds PMS accommodations

This mapping type suits you if you have 1 Cloudbeds PMS private room type with 1 room (unit) in it which corresponds to only 1 Airbnb listing.

  1. If that is your case, all you need to do is mapping the corresponding Airbnb listing from dropdown menu so it corresponds to the Cloudbeds PMS room type.

Example: Cloudbeds Accommodation (Deluxe) -> Channel Accommodation (Deluxe listing)

2. Mapping several Airbnb listings of the same type to Cloudbeds PMS room type

If you have one Cloudbeds PMS room type with several units and 1 listing on Airbnb - you can simply map it with the corresponding Cloudbeds PMS room type.

But if you sell room types in Cloudbeds PMS and several individual listings in Airbnb each corresponding to a specific unit - you will need to do the following:


In Cloudbeds PMS, you have Deluxe Studio (room type) with 5 units: Studio 1, Studio 2...

On Airbnb, you have 5 separate listings and these rooms have the same settings and description (mandatory): Studio 1, Studio 2, Studio 3...

While mapping the rooms in Cloudbeds PMS Room Mapping step, you will be able to map only 1 listing to your room type - so how can this be done?

  1. Go to Airbnb Extranet and keep only 1 listing of the same type in status Listed (all the rest of the listings of this type should be Unlisted)
  1. In Cloudbeds PMS, go to Channels
  2. Open Airbnb API Room Mapping page
  3. Link the room type to the listing with Listed status on Airbnb:
  1. Send a Full Refresh once finished to force an update of rates and availability to this listing.

How this configuration will work if my other listings are unlisted?

If Cloudbeds PMS room type has availability (no matter how many rooms (units)) > the listing will be bookable on Airbnb until all units are reserved. Your calendar will be opened for reservations.

If Cloudbeds PMS room type has no availability > the listing will not be bookable on Airbnb.

Therefore, all other listings should be unlisted otherwise you will be selling rooms that are not controlled by Cloudbeds PMS, which may cause inconveniences and overbookings.

3. Mapping dorm beds on Airbnb with Cloudbeds PMS shared rooms (dorm beds)

Scenario A

If you have one shared room type with 8 Beds in Cloudbeds PMS and 1 shared listing on Airbnb that corresponds to the room type that you sell on Cloudbeds PMS - you can simply map the Cloudbeds PMS room type to an Airbnb listing. Your guests will be able to take multiple bed/room bookings from Airbnb.

You don't need to create additional listings on Airbnb

Check the example below:

Listing configuration on Airbnb extranet: 1 bedroom with 8 beds that fits 8 guests

The number of beds must be equal to the number of guests. The bedroom - which corresponds to the room type - is always 1, even if you have multiple rooms types of this category as you will see in the scenario B , Cloudbeds PMS will send the availability to the same listing.

In Cloudbeds PMS, map the shared room type with their corresponding shared room listing in Airbnb.

Scenario B

Let's suppose that you have 1 shared room type with 2 or more units with 2 Beds each in Cloudbeds PMS - in such case, if you already have 1 listing on Airbnb for this corresponding shared room that you sell on Cloudbeds PMS, you do not need to create additional listings.

However, if on Airbnb you have several listings each of them representing a dorm bed in one shared room and you need to map them into 1 shared room (room type) in Cloudbeds PMS.

In that case, follow the instructions below:

In Airbnb extranet: Keep only one Airbnb listing representing dorm bed in status 'Listed'

  1. Go to Airbnb Listings page
  2. Among all the listings representing dorm bed from 1 shared room, keep only one listing in status Listed.
  3. All other beds from the shared room should be in status Unlisted
  1. Go to the Listed listing and open the Listing Details by clicking on its name. For example, bed in 6 beds dormitory - click on the name:
  1. On the right side of Rooms and spaces, click on Edit
  1. Under the Bedroom section, click on edit the Sleeping arrangements
  1. Choose the number and type of beds.

Be attentive to your bed type configuration in Airbnb.

If you have bunk beds on your bedrooms - which is common for dorm rooms - Airbnb will multiply the number of bunk beds to have the corresponding number of beds. If you choose 3 bunk beds, the total number of beds will be 6.

  1. Click on Done to save.
  1. Back to the Listing Details, scroll down to Property and Guests section
  2. Select the number of guests equal to the number of beds, in this example, 6 guests.

The number of beds must be equal to the number of guests. The bedroom - which corresponds to the room type - is always 1, even if you have multiple rooms types of this category.

In Cloudbeds PMS: Map the listing to Cloudbeds shared room

  1. Open the Manage (gear icon) page
  2. Go to Channels and search for Airbnb API
  3. Click on Enabled
  1. Open Room Mapping set up
  2. Map the shared room type in Cloudbeds PMS with the listing on Airbnb:
Powered by Zendesk