Our Channel Management feature is extremely powerful and can greatly simplify your channel advertising. Learn how it works by reading our Channel Management overview article. The most powerful part of our Channel Management is the API Integrations we have with certain channel partners like Airbnb.
This article provides a list of common questions and answers for the Airbnb API integration that are not covered elsewhere. This article assumes you have already connected the Airbnb API to OwnerRez. If not, do that first.
Questions are added to this page if they are miscellaneous in nature and we have not already answered them in other Airbnb support articles. Please read the Airbnb overview, connecting and rules & settings support articles for Airbnb before coming to this page as those articles cover the normal workflow.
- Adding a new listing to Airbnb after the API is connected
- Changing content on the Airbnb side
- How long do availability/rate updates take to show up on Airbnb?
- Can I take credit cards payments myself like other APIs allow?
- Collecting and remitting taxes
- How do resolutions work?
- There are no payments showing on new bookings
- Changing booking dates
- Is it necessary to run Channel Bridge with the API?
- How do I do discounts and have them available in Airbnb?
- How do I do weekly/monthly rates and have them available in Airbnb?
- How do I do surcharges that are available in Airbnb?
- How do I do security deposits through Airbnb?
- Can I have same-day bookings, but not too last-minute?
- I have two separate Airbnb accounts, can I connect to both of them?
- How do I get my pet fees into Airbnb?
- Can I display a message to guests before they book on Airbnb?
- I want to use Super Strict cancellation and I'm getting an error.
- I am a cohost on an Airbnb account, can I connect to it using the API?
- When I try to connect, there is an error saying that I can only have one property management software connected to Airbnb.
- I want to use the API, but I don't want to do Book Now.
- I have an age limit field or max adults/children set in my Property Rules, but Airbnb isn't honoring it.
- Can I make a "special offer" for a prospective guest?
- I need to temporarily hide/deactivate my listing on Airbnb.
- Why is Airbnb creating blocks on my calendar?
- How do I get historical data for my past Airbnb bookings into OwnerRez?
- Why is Airbnb showing a "base rate", and how can I change it?
- Why is Airbnb ignoring my "min nights" settings, and letting guests request to book shorter stays than I allow?
- I have a 'Plus' or 'Luxe' property - how do I maintain Plus or Luxe listings on Airbnb?
- I have several properties, and I want one of them to have different rules / rate adjustment / cancellation policy / lead time settings.
- My property exceeds Airbnb's max nightly rate of $10,000/night.
- How do I change my WiFi password on my Airbnb listing?
- What is Simplified Pricing and the 14% fee?
- Airbnb offers a 20% off discount for the first 3 bookings on a new listing. How do I turn that on?
Adding a new listing to Airbnb is done entirely from the OwnerRez side.
If you haven't already, first create a new property in OwnerRez. Then open the Airbnb API dashboard (under Settings > Channels > API Integration > click into Airbnb). Click the Change Property Mappings button.
Next to the new property, click on the drop-down and select "Create New Listing" and select the sync type to the right. You probably want the "Everything" option. Then click Save at the bottom.
When the page saves, OwnerRez will create a new listing on the Airbnb side and it map it back to your OwnerRez property.
Last, make sure to click the "Activate Listings" button and Activate your new property by selecting its checkbox and saving. This will make it live on Airbnb's site.
For more information about property mappings, read the "Mapping properties" section on the Setup and Connecting support document. Make sure to fill out the property content, rates and rules in OwnerRez on your new property so that the new listing on Airbnb is fully fleshed out. As you fill in property content, OwnerRez will push over that data to Airbnb in real time.
Once you go API, Airbnb disables (ie. "grays out") the fields on their control panel and you can no longer modify most settings on their side. This is true for all property content, rates, rules and availability. OwnerRez becomes the master record for all information so the channel turns off the ability for you to edit that directly and only communicates with OwnerRez for changes. There are a few select settings that still can be changed on the Airbnb side because they are not available to be set in OwnerRez (eg. tax collection). If you don't know how to set something on the OwnerRez side, please read our rules & settings article or ask us.
For some content in Airbnb, such as their step-by-step instructions for check-in, things get stuck in limbo when the API is turned on and the feed from OwnerRez doesn't update properly within Airbnb. If you have old info in that field and wish to change or delete it after an API integration, go to Change Property Mappings in the Airbnb channel in OwnerRez and switch the sync for that property to Limited mode. (API Integrations > Airbnb > Click the Change Property Mappings Button > On the Far Right Click the Drop Down and Choose Limited) That'll unlock the descriptions, etc. for editing on the Airbnb side. Go into your Airbnb account and edit the step by step instructions (or delete them entirely if you want to use the check-in instructions from OwnerRez). Then once you're done, go back to OwnerRez and flip the API Integration Channel Mapping sync back to Everything mode.
Once your account is live, we will push updates in about 20 minutes after you finish making changes in OwnerRez. Additionally, availability is checked instantly just before booking so there is no risk of a double booking against the information in OwnerRez.
If you have made a change and want to trigger an immediate sync, go to the Airbnb channel in OwnerRez and use Actions > Trigger Full Sync. That will queue the update for the next push which will go through within a minute or two.
No. Airbnb does not allow this and will still be the merchant of record for all payments even after you go API. We discuss this in more detail on the overview article and functional comparisons article.
Airbnb has several different possible tax collection modes -- some where they remit all taxes, some where you remit all taxes, and some that are a hybrid where they remit some taxes and you remit some taxes. We've broken the details out to a separate Airbnb Taxes article -- read that and make sure you've got the taxes set up accordingly in OwnerRez.
DO NOT enable the custom taxes option directly in Airbnb! If you do it in Airbnb, the setting will be overwritten next time OwnerRez syncs.
The API integration does not support resolution requests. This is a limitation of the API - Airbnb does not have a way of pushing the content to OwnerRez. They are working on supporting this and we anticipate adding this in the future.
However, you can still create resolution requests on Airbnb and the same process will continue to work. The resolution simply will not push into OwnerRez automatically. You have to manually change the charges and payments on the booking in OwnerRez to reflect what you collected or paid out.
One thing you will notice is that payments (or payouts) do not show on bookings in OwnerRez. This is a limitation of the Airbnb API - they do not push payouts to our system. Airbnb is working on adding this and we anticipate supporting this in the future. To be clear, the booking charges are created automatically but the booking will show that the guest owes the entire amount since no payments were recorded, and that will not change automatically.
To get around this problem, use our Channel Bridge tool to find and download payments from Airbnb and import them into OwnerRez. Channel Bridge will continue to work even after you go API.
You cannot change the booking dates (ie. arrival, departure) in OwnerRez. Even after going API, the dates must be changed from the Airbnb side in the same way you did it before going API.
Find the booking in Airbnb and click the option to make changes or alterations. Click the "Change Reservation" option.
After the alteration page loads, change the dates first and then set the new price (if the price needs to also change). The price may automatically change after you change the dates, so make sure to change the dates first before fixing the price.
Once you have the new dates and price entered, click Continue and Airbnb will send a request to the guest to confirm on their side. The guest has to approve it in order for the booking to actually change. Once the guest approves it, the change will push into OwnerRez automatically.
When you connect the Airbnb API, it will automatically pull over information on all your bookings past, present, and future. You do not need to run Channel Bridge to pre-populate your old bookings into OwnerRez. Also, the API automatically brings in all reviews past, present, and future with no further action required on your part.
However, you still need to run Channel Bridge occasionally, because payment data is not pushed to OwnerRez by Airbnb via the API (it's just not a supported feature). The charges are automatically brought into OwnerRez, but payments are not.
If you leave the API bookings in their default state, they will all show that the guest has an open balance because no payments were recorded. Running Channel Bridge will find the payouts in Airbnb and bring them over into OwnerRez so your accounting reports will be correct.
To create discounts in OwnerRez, go to Surcharges & Discounts, create one, and use the Discount type, applied automatically. Then use the Booking Fields under criteria to specify where it should apply.
Note that Airbnb does not necessarily interpret the discounts exactly as you design them, because of limitations in their rate engine. Your discounts as programmed into OwnerRez are mapped to Airbnb in the following ways:
- Weekly/monthly discounts will show in the week/month discounts settings on Airbnb if they are exactly 7 or 28 nights and have no date criteria. Otherwise (if they have date criteria or target a different length of time) they will be set as rules on the calendar.
- All other discounts - like last minute or early bird discounts - will be applied directly to the nightly rates.
- Airbnb only supports percentage-based per-stay discounts. Flat amount discounts must be per night. It is not possible to do a $100-off-your-stay discount, you'd have to do it as $20-off-each-night.
Generally, Airbnb doesn't support weekly/monthly type rates. Instead they support length-of-stay discounts.
If you do not have weekly or monthly rates, just use LOS discounts and leave it at that, they'll work in Airbnb and in your direct bookings.
If you already have weekly and/or monthly rates and are configuring the Airbnb API, you have two recommended approaches:
- Make the length-of-stay discounts only apply to Airbnb, by setting the Listing Site criteria on the discount to "only Airbnb". That way direct bookings will remain using the weekly/monthly rates you have set in your Seasonal Rates, and Airbnb will use the LOS discount.
- Use length-of-stay discounts everywhere, and remove all weekly and monthly rates from your Seasonal Rates.
Make sure you don't have both weekly/monthly rates and LOS discounts applying to direct bookings! If you do, both discounts will be applied - they will stack, and your direct-booking guests will get a super double discount. They'll be happy but you, not so much.
Airbnb supports special fees that can be configured in OwnerRez and will be calculated per stay. To trigger these fees, you can use one of the following keywords in your OwnerRez surcharge description:
These fees are handled specially by Airbnb, and operate with the following restrictions:
- They can only be per stay (not per night).
- Everything but Cleaning and Linen can be either percent or amount. Linen can only be amount.
- There can only be one matching fee per category -- any category with multiple surcharges will only get a single one, and any surcharge fee without a matching keyword will be ignored.
- Criteria will not be honored. For instance, you can't create a surcharge to be applied only to bookings longer than a certain number of days, or with more than a certain number of guests.
- Any per-night surcharge will be added directly to the nightly rate pushed.
On the guest display when a guest is looking for the quote, Airbnb will roll together all of these fees into the rate -- they do not show an itemized breakdown. So the rate as displayed to the guest will show the total of the following from OwnerRez:
- Nightly rate
- Channel rate adjuster
- Per night surcharges
- Matching per stay surcharges (except Linen), divided by number of nights and added to the nightly rate
- Linen fee, added to the cleaning fee
Airbnb includes the fees as follows:
|Fee name||Guest display (where each fee is mapped)|
|Cleaning fee||Cleaning fee|
|Resort fee||Nightly price|
|Community fee||Nightly price|
|Management fee||Nightly price|
|Linen fee||Cleaning fee|
You can set the security deposit rules in the Airbnb API integrations settings:
If you already have security deposit settings in your Property Rules, select the "Use OwnerRez Property Amount" checkbox. The amounts you have set for each property will be transmitted to Airbnb
If you do not have security deposits set for your properties, you can still have them unique to Airbnb. Select the "Specific Amount" checkbox, and enter a dollar amount in the field. This amount will be applied to all properties; if you use this method, you cannot set a different amount for each property.
Using this feature, Airbnb will ensure the security deposits are obtained. Note that they are held by Airbnb, not OwnerRez, and any charges against them must also be performed by and through Airbnb using their processes, not OwnerRez.
Security deposits set in this way will appear in your Airbnb listing:
Note that Airbnb security deposit holds, and charges against them, will be handled by Airbnb in accordance with Airbnb policy. They are not the same as OwnerRez security deposit holds that you control directly. They're still better than nothing though.
Also, your security deposit amount must be at least $127, and no more than $6,347.
Unlike most channels, Airbnb supports same-day bookings. You don't have to accept them - you can prohibit them by setting your Property Rules to require 1 day minimum in advance.
But if you do want really last-minute bookings, Airbnb lets you set a time cutoff so you at least have a little warning - say, noon. You set this time in the Airbnb API configuration settings:
Don't forget that this setting can also be overridden on a per-property level, under Properties > pick a property > Channel Rules:
"Use Channel Setting" means what it sounds like - whatever is set in the main Edit Airbnb Channel screen will be used. But it can be overridden to a specific different time for an individual property.
Yes, our API connection supports multiple Airbnb accounts! Simply create two separate Airbnb API connections, one for each account.
- Make the connection to your first Airbnb account in the usual way, and map the properties that are in that account. Do not map any properties that are in a different Airbnb account.
- In a different tab in the same browser, open Airbnb. Log out of all Airbnb accounts. Then, log in to the second Airbnb account, that is not currently connected to your OwnerRez account via API.
- Switch back to the browser tab with OwnerRez in it. Go to Settings > API Integrations > Connect a Channel button > Connect another Airbnb button.
- You will be brought through the same Airbnb connection authentication, but this time, a second Airbnb API connection to the other account will be created.
- In this second account, map the properties that are in that account. The properties that are mapped to the first account will be marked accordingly, and will not be available - one OwnerRez property cannot be mapped on more than one Airbnb API connection.
Both (or more) of these Airbnb API connections will display all your properties. But some properties will display a message that they are associated with a different account, as appropriate. They won't overlap or get mixed up.
Short answer: You can't! Airbnb doesn't do pet fees - the concept simply doesn't exist. If you select "I have pets" as an Airbnb guest, no fee will apply. Any pet fee settings you have in OwnerRez will be ignored by Airbnb.
If as an owner, you want to accept pets but to charge a fee for them, the only way to approximate this is to type into your house rules that pet fees are charged.
After the guest has a confirmed booking, you must then manually request payment for the pet against the booking using Airbnb's tools for requesting payment for additional services.
The OwnerRez setting of "no pets" or "pets allowed" is transmitted to Airbnb via the API. Note that the setting is in two places -- the Suitability Pets option on the Amenities tab of the property, and the Pets Max of 0 (or otherwise) on the Rules of the property. Both of these are needed in order to make pets allowed, and when they are, that status will automatically update to Airbnb.
Yes! It's called an "IB Message". You can set it in your Airbnb API connection settings.
Note that only plaintext is allowed (no HTML) and only 300 characters. This message will only be displayed if you have activated Instant Bookings on Airbnb.
Airbnb only allows you to use their Super Strict cancellation policy if you have identified and verified your business account with them (BAVI), so they know you're real and aren't a scammer. This must be done by Airbnb.
You can usually do this through your Airbnb dashboard, or by calling Airbnb support, but, they intended this option to be available for "professional hosts" only, and they tend to define this as having at least 6 property listings. It never hurts to ask them to turn it on for you anyway, but don't be surprised if they don't if you have fewer properties.
If they won't... sorry, you can't use Super Strict. :-( You'll have to settle for one of the other cancellation options.
No and yes.
It is not possible to connect to an Airbnb account using cohost login credentials.
However, if you are a cohost, presumably you are on good terms with the actual owner of the Airbnb account. If they'll share their actual main credentials with you, you can use them to set up the API connection in OwnerRez using the main account, and it'll work thereafter.
When I try to connect, there is an error saying that I can only have one property management software connected to Airbnb.
This happens when you were previously using a different property management software, such as LiveRez. It is not possible to be connected to more than one such PMS at a time - so if you are now going to be using OwnerRez, make sure you've canceled your service with the old one so you aren't paying for both!
Having done that, here's how to disconnect the old one so you can connect Airbnb to OwnerRez.
- Go to Airbnb, in the account section
- Click on the "Privacy & sharing" section.
- Is there a connected app for LiveRez there? Or anything else? If so, hit the "Remove access" link and remove the app.
- You should now be able to connect the Airbnb API in OwnerRez without errors.
Short answer: Tough cookies, you can't.
Yes, Book Now is a requirement of using the Airbnb API connection. However, Airbnb offers you several choices as to exactly who is allowed to Book Now in the OwnerRez API - Settings > API Integrations > Airbnb entry > Change button > look for the Instant Booking selection:
Carefully read that third option. How many unsuitable parties will still qualify if they
- Have verified government ID
- Have traveled on Airbnb before
- Have been recommended by other hosts
- Have no negative reviews
Probably not many. So even for highly selective owners, it is almost always possible and safe to use the Airbnb API. Just use the most restrictive setting as described above - everybody else will still have to Request To Book. :-)
To select this option, go to Settings > API Integrations > select your Airbnb API channel > Change button > look for the Instant Booking dropdown selector, and select the desired option > Save.
I have an age limit field or max adults/children set in my Property Rules, but Airbnb isn't displaying it.
That's right - they don't. Airbnb doesn't support an age limit field like OwnerRez, Vrbo and some others. They also don't count adults and children separately - as long as the total number of guests is less than your combined total of permitted adults and children (as in, the property max capacity of bodies), Airbnb allows it.
The only way to do this is to add a sentence to your House Rules about the age limit or maximum of adults or children. Go to Settings > API Integrations, click on the Airbnb channel, and change the settings.
Airbnb won't automatically enforce this policy, but it will be displayed to your guests, and if you have problems or need to cancel a booking because it does not comply, Airbnb will honor it then.
If you have different requirements for different properties (or other differing rules), you can set them separately for each property. Go to Properties > Pick a property > Channel Rules, in the left side menu. Select "Override Global Rules". Then enter the rules you want for that specific property.
Yes! You can issue "special offers" for an Airbnb guest from the Airbnb control panel.
This will also result in a Quote for the offer in OwnerRez. If you modify this quote in OwnerRez, the changes will be pushed back into Airbnb via the API, until the guest accepts the Quote and a Booking is created.
You can do this under Settings > API Integrations > click the Airbnb entry > Deactivate Listings. You'll get a list of active listings; click the checkbox to Deactivate the ones you want to turn off, and Save your changes.
Note that this is not deactivating the API connection. This is deactivating the actual listing, so your property listing will now not appear in Airbnb searches by guests.
Like any online purchasing process, it takes time for a guest to complete a booking online. When a guest begins the process, they know what dates and property they want. Airbnb checks with OwnerRez to make sure they are available.
It may take a few minutes for the guest to complete the whole process, though. We want to make sure the requested dates are still available when the reservation is finalized, so we block off those dates to hold the calendar open until the guest is finished and the booking is made.
Normally, these blocks will not be visible for very long - they'll quickly turn into a real booking. Occasionally, however, a block may remain active for a few hours - such as, if there are issues with the guest's credit card. The guest is given an opportunity to provide a different payment method, and in the meantime, their dates are held available for them.
Note that this only occurs while an actual booking is in progress. Airbnb also offers guests the ability to make a "request", and blocks the dates for 24 hours. OwnerRez does not honor these requests or block your calendar for them. Don't worry about double bookings though - Airbnb does a final check before confirming a completed booking when a "request" is accepted, and if the dates have already been booked, it'll notify the guest and not allow the booking process to be completed.
Sometimes, the Airbnb API is very generous that way - as soon as you have connected a property via the API, almost all historical booking information for that property is automatically brought into OwnerRez. Only two important data aren't:
- The guests' real email addresses - and there's no way to get those, either, because the Airbnb proxy email addresses that are provided stop working after the guest departs. You do get their name, mailing address and phone number though.
- Records of the guests' payments, since the Airbnb API doesn't support this. So all your OwnerRez reports will show none of your Airbnb guests as having paid. This can be fixed using Channel Bridge, which is able to get payment records and import them into OwnerRez.
No double-bookings or collisions will occur - OwnerRez will automatically merge new information into existing bookings if they match, or skip entries that don't.
And other times, the API will bring in nothing about past bookings at all. Airbnb seems to be starting to consider this a security risk. In this case, you'll have to use Channel Bridge to collect all your historical data. But, you have to do that anyway to bring in past payment records, so it's no real difference.
💡 Note that connecting the API does not bring in any information about blocks you may have created in Airbnb - just bookings. The blocks will not be imported for you. If you haven't already put them into OwnerRez, they'll be deleted from Airbnb.
The base rate is a number OwnerRez has to supply - it's required by the API integration - but it's not really used, since a nightly rate is pushed for every night of the year. But to satisfy the requirements of the API, we set the base rate to the highest rate of your year to be safe. That way, if for some reason the nightly rates fail, the base rate will not give out too low of a rate.
This rate will also include any rate increase that you have set for the Airbnb channel specifically in your API settings.
To be clear, it is not normally visible to guests or used for quotes.
Why is Airbnb ignoring my "min nights" settings, and letting guests request to book shorter stays than I allow?
Airbnb isn't ignoring your rules, exactly - it honors them, in the sense that it won't allow guests to make Instant Bookings that violate them.
However, it still allows guests to Request to Book stays that violate your rules. You can decline these requests without penalty.
It is not possible to prevent receiving these requests.
Congratulations on getting Plus or Luxe rated on Airbnb! That's a great benefit to attract more guests.
Unfortunately, there is no way to control or manage the content side (photos, descriptions) of Plus and Luxe listings via API. This is a limitation on the part of Airbnb, not OwnerRez. Once an Airbnb listing is flagged as Plus or Luxe, the Airbnb API will not override it with content changes from a PMS system (like OwnerRez).
Because of this, you should use the 'limited' connection type for Plus or Luxe properties in OwnerRez, which will update rates and availability, but nothing else.
I have several properties, and I want one of them to have different rules / rate adjustment / cancellation policy / lead time settings.
You can do this! First, make sure that you have these settings configured in the Airbnb API Channel settings for your regular defaults.
Then, for the property that needs to be different, go to Properties > pick the property > Channel Rules, in the left menu > Change button. You will see a list of options for the APIs that property is connected to. By default they are all set to "Use Global Rules", which means whatever is set in the main API channel settings.
But, you can override them for each property individually in this screen. Make your changes and save, and they'll be transmitted to Airbnb via the API connection.
Rate adjustment: This one doesn't have an override under Channel Rules. Instead, create a Surcharge, and use the Criteria to set it to be used for the specific property and channel you want different. Don't forget that the surcharge will be added to any Rate Adjustment already in place on the channel - so if you regular Airbnb API rate adjustment is 10%, and you have one property that you want to be 15%, create a Surcharge for that property, Airbnb channel only, for 5%.
Our API connection has a max nightly rate too, but a much higher one - $25,000 per night. If this is insufficient, please reach out to the Helpdesk for assistance.
BTW, the minimum nightly rate allowed on Airbnb is $10.
With difficulty... The Airbnb API does not support this particular data. However, with the API active, you aren't allowed to change it in the Airbnb control panel either.
To fix it:
- Go to the Airbnb API channel settings in OwnerRez, click the Change Property Mappings button, and use the drop-down selector to switch that property listing to Limited mode. Save your changes. That will unlock the content fields on the Airbnb site.
- Log in to your Airbnb control panel - you'll now be able to update the Wi-Fi field over there.
- Once it's successfully changed, saved, and displaying correctly, go back to OwnerRez and switch back to Everything mode in the Airbnb API Mappings.
Historically, Airbnb has had a single fee structure for all hosts, in which a service fee is charged to both the host (3%) and the guest (under 14.2% in most cases). In December, 2020, they launched a new fee option for software-connected hosts to remove the guest service fee and charge hosts a 14% fee. This fee structure is known as Simplified Pricing. This pricing is for all software-connected hosts on Airbnb globally (the switch currently excludes US, Canada, Mexico, Uruguay, The Bahamas, Argentina and Taiwan). Beginning with reservations made on/after 12/7/2020, Airbnb will deduct a flat 14% host service fee from each payout and won’t charge a guest service fee.
If you wish to convert over, go into your Airbnb account in the "Payments & payouts" section and switch the service fee tab to "include all Airbnb service fees in your price". Here's a direct link: https://www.airbnb.com/account-settings/payments/api-host-service-fee
If you have chosen this option in Airbnb, you should also select the Professional Hospitality Business = Yes option in your Airbnb API settings screen in OwnerRez.
You can't activate that discount from OwnerRez. However, you can do it from this page on Airbnb.