Connecting Airbnb API to myfrontdesk

Follow

We are glad to announce Airbnb and Cloudbeds 2-Way API Integration!

Benefits of the Airbnb API connection:

  1. Full sync between Cloudbeds and Airbnb listings. We will automatically update your
    • rates
    • availability
    • restrictions (MinLos, MaxLos etc.)
    • cancellations
    • modifications
  2. The sync is instant and is not delayed
  3. Support of sync for room types with multiple units of availability

We are rolling this API out to properties in phases. If you received an email that your property has been approved for an API connection - please proceed to section "Connection Guide"

If you're new to connection - please check this article first: Airbnb API Sign Up Process and Minimum Requirements

Limitations of Airbnb API Connection

When the listing is connected via Airbnb API it's not possible to use the Smart Pricing and the discounts on Airbnb:

  • Length-of-stay discounts
  • Early-bird discounts
  • Last-minute discounts

If you're selling the accommodations with discounts at the moment - please pay attention to this limitation as after the sync all the discounts will be disabled. This limitation can be resolved later, please contact our Support team to check the current status

Before Connection
  1. Make sure you've read and completed the requirements for the connection in this article Airbnb API.  How to Apply for Connection, Minimum Requirements and FAQ
  2. If you're connected to another channel manager on Airbnb - please disconnect it: go to your Airbnb account > Connected Apps > select the channel manager you're connected to > click Remove App
Airbnb API Connection Guide

Before mapping make sure that the rooms setup in myfrontdesk and Airbnb match (room occupancy, room type).

Step 1: Check Airbnb API status on 'Channels' page in myfrontdesk

By default Airbnb (API) channel is in status 'Not setup' for all the properties:

You need to send a connection request to support@cloudbeds.com: after that our Support team contact you and switch the channel status to 'Ready for mapping' owhich means that you may proceed with the connection

Step 2: Authorize Cloudbeds to manage your Airbnb listings

Now you need to authorize Cloudbeds myallocator (channel manager for myfrontdesk) to manage your Airbnb listings:

  1. Login to myfrontdesk and go to Manage
  2. Open 'Channels' page
  3. Search for Airbnb (API) and click 'READY FOR MAPPING, CLICK TO START MAPPING'
  4. Enter Airbnb listing's owner login and password (not the co-host's credentials). If you still see an error - please logout from all the Airbnb accounts in your browser(s) and authorize again
  5. Agree with the Airbnb terms and conditions and confirm that you authorize myallocator clicking 'Allow'

If you connect one Airbnb account to several myfrontdesk accounts - you will see a yellow alert, you can ignore it and proceed with authorization

Step 3: Mapping process

Airbnb API mapping process is very much alike the mapping process for the common channels like Booking.com or Expedia. You will need to link the myfrontdesk room type with the corresponding Airbnb listing and click 'NEXT' once all the room types are linked:

The mapping process may differ depending on the room setup that you have on Airbnb (individual listings, room types, dorms). See the mapping guide for different scenarios below.

Once you click on 'Next', if you see a warning message on the top of the page saying that some rooms are left unmapped, go ahead and click OK to move forward

Step 3.1: Mapping individual Airbnb listings with individual myfrontdesk accommodations

This mapping type suits you if you have 1 myfrontdesk room type with 1 room in it which corresponds to 1 Airbnb listing.

Select the Airbnb listing from dropdown so it corresponds with myfrontdesk room type.

Click NEXT once you're finished, go to the channel setup again - if you did everything right and there are no errors the mapping is successful!

Step 3.2: Mapping several Airbnb listings of the same type to myfrontdesk room type

If you have one myfrontdesk room type with several units and 1 listing on Airbnb - you can simply map it with the corresponding myfrontdesk room type. Most of you still have only one listing on Airbnb - in such cases, you do not need to create additional listings and you can move to Step 4.

But if you sell room types in myfrontdesk and several individual listings in Airbnb each corresponding to a specific unit - you can map your myfrontdesk room type to any of corresponding listing on Airbnb (if these Airbnb listings totally match between each other in settings and description).

Example:

In myfrontdesk 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: Studio 1, Studio 2, Studio 3...

On room mapping step you will be able to map only 1 listing to your room type - how this can 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 put by you to status 'Unlisted'

2) in myfrontdesk on room mapping page link the room type to the only listed listing:

3) after Full Refresh myfrontdesk will send the rates and availability to the mapped listing.

If myfrontdesk room type will have availability (no matter how many rooms) > the listing will be bookable on Airbnb

If myfrontdesk room type will have no availability > the listed will be not bookable on Airbnb

Step 3.3: Mapping dorm beds on Airbnb with myfrontdesk shared rooms (dorm beds)

Scenario A) If you have shared room type with 8 Beds on myfrontdesk and 1 shared listing on Airbnb that corresponds to the room type that you sell on myfrontdesk - you can simple map the myfrontdesk room type to an Airbnb listing. Your guests will be able to take multiple bed/room bookings from Airbnb

You do not need to create additional listings on Airbnb.

Scenario B) Let's suppose that you have 1 shared room type with 2 units with 2 Beds each in myfrontdesk - in such case,

if you already have 1 listing on Airbnb for this corresponding shared room that you sell on myfrontdesk, you do not need to create additional listings.

But 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 myfrontdesk - this is how you can do that:

Step 1. Keep only one Airbnb listing representing dorm bed in status 'Listed'

1) BEFORE mapping in myfrontdesk, go to Airbnb > open your Listings > among all the listings representing dorm bed from 1 shared room keep only the one listing in status 'Listed'. All the rest of the beds from the shared room should be in status 'Unlisted'

2) go to the listing which is in status 'Listed' > open 'Listing Details' > 'Rooms and Guests' > Edit

Set the total number of beds in the dorm for the fields "Beds" and "Guests". In example below it's 4 beds

Step 2. Map the listing to myfrontdesk shared room

Go to myfrontdesk > Channels > Airbnb API > map the shared room type in myfrontdesk with the listing on Airbnb:

If you receive an error during the mapping steps - please consult this article: Errors during Airbnb API mapping process and issues after connection

If you can't resolve the error - please contact our Support team at support@cloudbeds.com

Step 4: Base Rate Adjustment

Here you can enter a discount or an increase of your base rate for all room types mapped if needed

For example, if you want Airbnb channel to have a 5% rate discount compared to other channels, you would enter - 5% for each room.  The same applies for higher rates.

The Rate Differences can be set in a Percentage Amount or a Fixed Currency Amount.

For more info please check this article: How to Adjust Charge / Add Adjustment to a Reservation

Step 5: Send Full Refresh

This is the last screen of mapping process: here you can see all the features supported in connection between myfrontdesk and Airbnb API.

Keep the box on this screen checked - this will send full refresh to all rooms mapped with Airbnb

You can also send Full Refresh on the 'Channels' page by clicking 'Full Refresh' button:

Step 6. The sync is established!

On Channels page you will see Airbnb (API) set on status 'Setup Complete':

You can return to mapping page any time to edit the room mapping or add base rates adjustment. On room mapping screen you will see which rooms are already mapped:

After completing the connection, you will notice that the ‘Sync Status’ on Airbnb extranet will display as ‘Limited’ - this is normal, it means myallocator will not override your pictures, descriptions - myallocator updates only your rates and availability.

Step 7. Double check the accuracy of rates and availability sent to Airbnb

Now when your rates and availability in Airbnb are controlled by myfrontdesk, it's important to make sure that the rates and availability are correct on the channel.

To preview Airbnb listing, its prices and availability (as your guest will see it), follow the steps below:

1) login to Airbnb Extranet and go to 'Listings'

2) open the listing that you want to check and click 'Preview listing'

3) on new page you will see a header 'Preview mode'

4) select the dates of stay and number of guests

Check the rates and availability accuracy, they should match base rates and availability on myfrontdesk for the selected room type (listing)

Step 8. Add tax/fee or commission if applicable

1. Go to Reservation Sources page in myfrontdesk

2. Open 'Third Party Sources' tab

3. Add Airbnb API as new source (if not yet added) and apply fee and/or tax for reservations from Airbnb if needed

4. Click SAVE

Now the taxes/fees applicable will automatically be added to Airbnb reservations (API connection)

Step 9. Disable Airbnb ical connection (if was previously connected)

If before connecting Airbnb API you HAD Airbnb ical connection active - you need to disable it.

1) go to Channels

2) go to Airbnb (ical)

3) delete all the links

4) go back to the channel and remove the checkmark

Possible errors during connection

If you face any errors during the connection - please refer to this article Errors during Airbnb API mapping process and issues after connection or contact our Support team at support@cloudbeds.com

How do I stop the sync between myfrontdesk and Airbnb listing?

There could be possible reasons why you'd like to stop sync between Airbnb listing and myfrontdesk:

  • information in Airbnb after sync is incorrect
  • some settings are not editable
  • fees were not set

To stop the sync between Airbnb listing and myfrontdesk

1) go to Airbnb Extranet and open Listings tab

2) click 'Cloudbeds' (MyAllocator)

3) click the three dots menu next to listing

4) click 'Stop sync'

After that - please contact our support team at support@cloudbeds.com to disconnect myfrontdesk from Airbnb API on our side.

Support Contact Details:

We are always here for you! In case you need any assistance with connecting Airbnb to myfrontdesk - feel free to reach out to our dedicated team:

  • Cloudbeds Support Team: support@cloudbeds.com

You can also contact Airbnb team in case you need help with making changes on your Airbnb account:

  • Airbnb Support Team: +1-855-424-7262
Have more questions? Contact Support

Comments

Powered by Zendesk