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.

How to Connect Airbnb API to Cloudbeds PMS

Follow

This article will guide you on how to connect Airbnb API channel to your Cloudbeds PMS.

The API connection includes:

  • Full sync between Cloudbeds PMS and Airbnb listings. We will automatically update your rates, availability, restrictions (MinLos, MaxLos etc.), cancelations and modifications;
  • The sync provides an instant connection to your Airbnb listing(s);
  • Support of sync for room types with multiple units;
  • Support for Discounts, Pricing Rules, Availability Rules, and Taxes/Fees.

Smart Pricing is not supported when connected to Airbnb via the API connection due to how pricing works when using a management system. The Airbnb Smart Pricing is an algorithm that attempts to modulate the price during busy and slow seasons to maximize revenue while also keeping prices attractive for customers.

When connected to a system like Cloudbeds PMS, that pricing methodology is no longer applicable because we are setting all of the pricing.

Before Making the Connection

Make sure:

  • Your listing(s) status is Listed on the Airbnb extranet (the sync will not work if the listing is not active/listed on Airbnb)
  • The room configurations (room occupancy & room type) on Cloudbeds PMS and Airbnb match.
  • The currency settings on Cloudbeds PMS and Airbnb are the same currency.
  • The default property time zone on Cloudbeds PMS and Airbnb match.
  • You are not connected to another Channel Manager.  If you are, go to your Airbnb extranet > Account > Privacy & Sharing> Connected Apps > click on Remove Access.
  • You create all the needed blocks on Cloudbeds calendar — if you had any on Airbnb prior to making the connection. Because any manual blocks you had in Airbnb before connecting it to Cloudbeds will be automatically deleted/overridden as soon as the connection is initiated. 

For more information on how to onboard to Airbnb, check out Airbnb Onboarding Guide.

For additional information, refer to Airbnb API and Minimum Requirements.

Airbnb API Connection Guide

Step 1 - Enable / Authorize Airbnb API on Cloudbeds PMS
  • Before start the mapping process, be sure to log in as the Listing Owner on Airbnb extranet. All other users (such as, co-hosts and hosting team) are unable to connect the channel to Cloudbeds PMS. If you have any doubts regarding your user, check this Airbnb article: What is a primary host?

In Cloudbeds PMS,

  1. Open Manage (gear icon) page
  2. Go to Channels  
  3. By default, Airbnb (API) channel status is Not Setup for all properties, click on it to set up
  1. Click on Enable Channel

Authorize myallocator (channel manager by Cloudbeds) to manage your Airbnb listings

  1. Login with your Airbnb listing's owner login and password (not the co-host's credentials).

If you see any errors, log out from all the Airbnb accounts in your browser(s) and authorize again.

  1. Agree with the Airbnb Terms and Conditions
  2. Click on Allow to confirm that you authorize Cloudbeds PMS

A message confirming the authorization should pop-up once completed:

Step 2 - Start mapping Airbnb API to Cloudbeds PMS
  1. Map the room types created in Cloudbeds with their corresponding rooms (listings) in Airbnb following the instructions below:

The mapping should be one-to-one, do not link one room type with multiple listings or vice-versa.

The mapping process may differ depending on the room setup that you have on Airbnb (individual listings, room types, dorms). If you have doubts, check the mapping guide for your scenario below:

  • If you manage multiple properties under the same Cloudbeds login, you will see the warning message below - ignore it and continue to next steps.
  • If you have multiple properties in Cloudbeds PMS and your single Airbnb account is used for all of them, you can also link it to Cloudbeds PMS accounts as long as you have multiple listings to each property to prevent sync issues.

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

If you can't resolve the error, contact our support team.

Step 3 - Set Up/Edit Room Settings Details

Once you map the rooms, you will be directed to the Room Settings page to edit the listing details or review them. For more details on each topic presented, check out this article article: Airbnb API - Room Settings

  1. Click on Configure next to each room.
  1. Review settings for that listing: Price, taxes, pricing rules and discounts. Click on View/Edit to review them.
  1. Check your Price Settings
  1. Taxes
  1. Pricing rules & discounts

A successful room setup will be displayed in Room Mapping page as Setup Completed:

Step 4 - Base Rate Adjustment

If needed, add a base rate adjustment in percentage or fixed amount on this page.

For more information on how the Base Rate Adjustment works, check this article: Base Rate Adjustment or How to Send Different Rates to Channels

Step 5 - Send a Full Refresh

Once you finish mapping Airbnb API, send a Full Refresh on the top right corner of the Channels page to force an update to the channel.

You may return to mapping page any time to edit the room mapping, room settings or add base rates adjustment.

In the Room Settings page, check if your listings are well mapped or if they present errors/missing settings:

After Completing the Connection

  1. Double-check the accuracy of rates and availability sent to Airbnb by checking your Airbnb listing calendar and simulating a reservation as a guest.
  2. Add the taxes/fees or commission, if applicable, to Reservation Sources: Airbnb API on Cloudbeds PMS.
  3. Disable the Airbnb iCal connection (if the iCal was previously connected) to avoid conflicting updates to your Airbnb account.
  4. Once the connection is completed, Hosts will not be able to perform any changes such as rates, availability and restrictions on Airbnb extranet — these options are greyed out (blocked). The Co-Host, however, can still technically perform the changes as those options are not blocked for them but they should never do so - modifying rates, availability and restrictions directly on the extranet might cause serious issues such as price and availability discrepancies or even overbookings.

If you use Whistle for Cloudbeds, be sure to enable the messaging permission following this guide.

For more information about Airbnb API, visit our Airbnb API - Frequently Asked Questions page.

If you need any assistance with connecting Airbnb to Cloudbeds PMS - reach out to our dedicated team:

Support Contact Details:

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

Powered by Zendesk