How to Connect Airbnb API to myallocator


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

This includes:

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

Note: 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 myallocator, that pricing methodology is no longer applicable because we are setting all of the pricing.

Before Making the Connection

Make sure that:

  • 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) in myallocator and Airbnb match.
  • The currency settings in myallocator and Airbnb match.
  • The default property time zone in myallocator 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.

For additional information or if you run into problems, please refer to: Airbnb API and Minimum Requirements and FAQ

Airbnb API Connection Guide

Step 1. Enabling / Authorizing Airbnb API on 'Channels' page in myallocator

Before start Airbnb mapping, be sure to be logged in the Listing Owner account in the extranet. All other users (such as, co-hosts and hosting team) will be unable to connect the channel to myallocator. If you have any doubts regarding your user, check this Airbnb article: What is a primary host?

  1. Click on 'Channels' tab
  2. Then, click on 'Add Channel' and search for Airbnb API
  3. Click on 'Not Setup' to start the mapping process

Authorize myallocator to manage your Airbnb listings

4. Click on Next to proceed
5. Enter Airbnb listing's owner login and password (not the co-host's credentials). If you still see an error - please log out from all the Airbnb accounts in your browser(s) and authorize again.
6. Agree with the Airbnb terms and conditions and confirm that you authorize myallocator clicking 'Allow'

  • Make sure that the currency which is set in myallocator for AirBnb channel and the currency for each listing on the Airbnb extranet are the same, Otherwise there will be an error in the connection and we won't be able to update the pricing on the channel.
  • Make sure that your default property time zone on myallocator and Airbnb extranet are the same
Step 2: Mapping process

Airbnb API mapping process is very much alike the mapping process for the common channels like or Expedia. You will need to:

1) link each of your myallocator room types with the corresponding Airbnb listings.
2) click 'Update' in order to configure your listing details for each of your listing (for more details on this, please refer to 'Step 3: Set Up/Edit Room Configuration Details')

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.

If you manage multiple properties under the same myallocator login, you will see the warning message below, you can ignore it and move forward.

Step 2.1: Mapping individual Airbnb listings with individual myallocator accommodations

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

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

Step 2.2: Mapping several Airbnb listings of the same type to 1 myallocator room type

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

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


In myallocator, 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, 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')

2) in myallocator room mapping page, link the room type to the listing with 'listed' status on Airbnb:

3) after a Full Refresh, myallocator will send the rates and availability to the mapped listing.

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

If myallocator room type will have no availability > the listing will not be bookable on Airbnb

Step 2.3: Mapping dorm beds on Airbnb with myallocator 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 myallocator - you can simply map the myfallocator 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.

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 , myallocator will send the availability to the same listing.

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 myallocator, 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'

  1. Go to the listing which is in status 'Listed' > open the 'Listing Details' by clicking on its name. For example, bed in 6 beds dormitory:
  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.

Step 2. Map the listing to myallocator shared room

Go to myallocator > 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

Step 3: Set Up/Edit Room Configuration Details

After you click on the 'Update' button, you will be directed to the following page with two options. The options are:

1) Import settings from Airbnb extranet (recommended): if you have previously set discounts, pricing rules, availability rules, taxes/fees on the Airbnb extranet, you can quickly import these settings by selecting this option.

2) Use settings in this system: please select this option if you wish to overwrite your Airbnb extranet settings with new values from myallocator.

Once you've clicked on your preferred option above, you will be redirected to 'Room Export' page.

1. Availability Rules

  • Advance Notice: The settings in this section are Airbnb default settings. Now that you are connected to Airbnb via myallocator, availability is now controlled by the values entered in our system's calendar.
  • Guests can book: since your availability is now controlled by myallocator, guests can book any time your listing has availability on you calendar.
  • Availability Window: Since your availability is controlled by myallocator calendar, any dates that do not have availability on the calendar will be unbookable by default.  Dates that have availability on the calendar will be bookable.
  • Minimum Length of Stay (in nights): the minimum length of stay is controlled by myallocator 'Min LOS'settings. Any dates that do not have a Min LOS set will default to 1 night.
  • Days of week allowed for Check In: this is controlled by the 'Closed to Arrival' settings inside myallocator.
  • Preparation Time: this is not available at this time.
  • Maximum Length of Stay (in nights): the maximum length of stay is controlled by myallocator 'Max LOS' settings and will default to no maximum.
  • Days of week allowed for Check Out: this is controlled by the 'Closed to Departure' settings inside myallocator.
  • Minimum stay by day of week: the minimum length of stay is controlled by myallocator 'Min LOS' settings.  Any dates that do not have a Min LOS set will default to 1 night.

If you would like to set up booking cut-off time, please refer to this article.


  • Once the cut-off time is set, it might take until the next day for the adjustment to take place. For example, if you updated your cut-off configuration to not allow same-day bookings, this will become effective the next day.
  • This cut-off time applies to all your connected OTA's.

Configurations that are not controlled by our system after the connection will have the 'Edit' button clickable. Therefore, please manage them directly on Airbnb extranet.

For example, to manage your check-in and check-out windows, please perform the following steps:

1) Go to your listing and click 'Booking Settings"
2) Scroll down to the 'Policies' section and click the 'Edit' button
3) Set up your check-in window preference
4) Set up your check-out window preference
5) Click 'Save'

2. Price Settings

  • General
    • Listing Currency: the currency chosen here must match the currency you want your rates to be sent in
    • Listing Base Nightly Price: rates are controlled by myallocator calendar. Any dates that do not have a rate entered in myallocator will default to this rate.
    • Weekend Pricing: rates (including weekends) are controlled by myallocator calendar. Any dates that do not have a rate entered will default to this rate.
  • Length of Stay Discounts
    • Weekly Discounts %: Airbnb will calculate the weekly rate based on this discount if your guest selects 7 or more nights.
    • Monthly Discounts %: Airbnb will calculate the monthly rate based on this discount if your guest selects an entire month.
  • Extra Guest Pricing
    • Add the number of guests included in price
  • Extra person fee (per night): please add (if applicable) this fee in a fixed amount per night for private rooms only.
  • The shared dorms must have the extra person fee as zero in mapping and also in the extranet.
  • The guests number included must be 1 - The system will multiply the rate according to the number of guests/beds reserved.
  • Standard Fees
    • Security Deposit: please add (if applicable) this fee in a fixed amount.
    • Cleaning Fee: please add (if applicable) this fee in a fixed amount.
  • Other Fees: for each of the listed fees, you can input either a percentage or a fixed amount.

For shared dorms:

3. Pass Through Taxes

  • Taxes
    • Tax Type: your options include "hotel tax", "lodging tax", "room tax", "sales occupancy tax", "tourism assessment fee", "tourist tax", "transient occupancy tax", and "VAT GST".
    • Amount Type: your options include "flat per guest", "flat per guest per night", and "percent per reservation".
    • Business Tax ID: your tax ID is a unique number relating directly to your business.
    • Registration ID: this is your accommodations tax registration number, which is the unique number you were assigned by your local taxing jurisdiction.
    • Amount: please input your tax amount.
    • Long Term Stay Exemption:
      • "A booking may be eligible for a long-term stay exemption if it meets certain qualifications. What qualifies as a long-term stay depends on the jurisdiction the listing is in. For example:
      • Jurisdiction X - a booking greater than 30 days isn’t taxed
      • Jurisdiction Y - a booking greater than 45 days isn’t taxed
      • Jurisdiction Z - for bookings greater than 30 days, taxes only apply to the first 30 days
      • Check with your local tax authority to find out more information on your jurisdiction’s long-term stay exemption." - How do I add custom taxes to my listings?
  • Confirmation: if you have any taxes listed, you will need to click on the confirmation box before you click 'Save and Sync'.

These taxes will not be applied to the rates myallocator sends to Airbnb. Airbnb will take these values and apply them to the bookings as they come in.

Example: Suppose your room rate (on your availability page) is $100.00 and you have configured a 10% tax. Myallocator sends rate of $100 to Airbnb. Airbnb shows rate of $100.00 to your guests. Once a guest books, Airbnb automatically adds $10.00 (the 10% tax) to the booking total, and sends both values ($100.00 for room revenue and $10.00 for taxes) to myallocator.

If Airbnb pays taxes on your behalf:

  • the taxes are automatically configured inside Airbnb extranet, therefore, you do not need to set up these taxes inside our room mapping
  • Airbnb will send the total expected payout (the amount they will pay you) to our system, therefore, these taxes will not be included in your rate breakdown.

If any assistance is required with setting up your Airbnb taxes, please reach out to Airbnb team at

4. Pricing Rules & Discounts

  • Pricing Rules
    • Rule Type: your options include "booking ahead" (minimum days ahead), "last-minute booking" (maximum days ahead), "long term stay" (nights), and "seasonal".
    • Price Change: please input your discount amount.
    • Price Change Type: your options are "percent" or "absolute."
    • Days/Nights Threshold: please input the number of days/nights threshold for the discount you're adding.
    • For Check-In Dates: please input the date range for the discount you're adding.

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. Therefore, if you have multiple discounts of the same type configured, myallocator will apply the discount that results in the highest price.
Please note that percent-based discounts will override fixed amount discounts.

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 - 20%' 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 both:

Example 2:

  • Long term Stay (nights) - more than 10 days - 24% for period x
  • Early Bird discount - more that 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, myallocator will send the rate of $80 to Airbnb (since it's the highest rate).

5. Click on 'Save and Sync'

6) Click 'Next' once all the listings are mapped and updated.

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 4: Set Up Base Rate Adjustment if needed

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.  

If you want to send 11% higher rates - you would enter +11%.

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

Step 5: Send Full Refresh

This is the last screen of mapping process: here you can see all the features supported in connection between myallocator 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 'Calendar' page by clicking 'Full Refresh' button:

Step 6. Congratulations - the sync between myallocator and your Airbnb account is established!

On Channels page, you will see Airbnb (API) channel status is 'Setup Completed':

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 myallocator, 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) log in 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 myallocator for the selected room type (listing)

Step 8. Disable Airbnb iCal connection (if iCal was connected)

If you have 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 Contact Details:

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

  • Myallocator Support Team:

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

Have more questions? Contact Support