How to Connect an Airbnb Account and its Listings

From hoteliga
Jump to: navigation, search

In order to add a new AirBnb connection to your hoteliga account please follow the steps described below:

Connect your Account

Authorize the AirBnb Account

At this moment, you are supposed to already have an AirBnb account. You are advised to open a tab in your browser and log in to the Airbnb account.

In the hoteliga account, navigate to the Channel Manager area (Options ⇒ Channel Manager) and go to the Accounts page, the first button in the AirBnb (Official) area.

Channel manager accounts.png

You should be able to see the AirBnb (Official) area (image above). If you don't, it means you don't have permission to create an AirBnb channel (please contact hoteliga support for more information).


In Accounts, you will see an empty page with a red button “Connect with Airbnb”:

Accounts grid en.png

  • Before clicking the button, make sure that you are logged in to your AirBnb account.
  • The button “Connect with Airbnb” will redirect you to the Airbnb page, where you will give access to hoteliga:

Airbnb terms en.png

  • After giving access, you will be redirected back to account list:

Added airbnb account en.png

The account was authorized successfully.

To add another account, repeat 1-3 steps above.

Unauthorize your AirBnb Account

To disconnect an Airbnb account, go to Accounts and click on the account you want to disable and select "Disconnect account":

Disconnect airbnb account en.png

After disconnecting successfully, no information about this account will be available to hoteliga.


You can also remove the access from your Airbnb control panel:

Airbnb remove access en.png


If you do so, you also have to remove this account from hoteliga by clicking "Remove disconnected account" (Accounts page).

Manage the Listings

Airbnb Listings are equivalent to hoteliga room types. If a room type has more than one rooms, all rooms should offer the same amenities and services.


Once you authorize access to the Airbnb account, all listings will become available for connection in hoteliga channel manager.

For example, you have 3 listing in your Airbnb account:


Airbnb listings en.png


Inside hoteliga Listings (Channel Manager ⇒ Listings, second button in AirBnb section) you will be able to see all the Airbnb listings from all the authorized accounts:


Listings hoteliga en.png


The meaning of each column is:

Listing name: the name you have set inside Airbnb account for a listing
Account email: the email of the authorized account
Room type: associated hoteliga room type title (when the listing is connected)
Available: if a listing is available, no – listing is not available, and no reservation can be made
Connected: if a listing is connected, that is prices and inventory are managed through hoteliga
Channel name: the channel name which will be created in hoteliga and associated with airbnb listing
Sync category:
  • Disconnected – a listing is not managed by hoteliga
  • Limited - hoteliga sends updates only about prices and availability

Connect an AirBnb listing

When you click on a listing, you will see a modal, where you can edit only 3 fields:

  • Room type
  • Connected
  • Available

Listing modal en.png


To connect a listing to hoteliga you should choose the appropriate hoteliga room type and enable Connected.

Connected listing en.png


When you reopen the window you will see that Available is enabled, there is an associated Channel name and the Sync category is Limited.

Complete connected listing en.png


The field Approved means that from AirBnb side this listing was checked for minimum required information (title and at least one photo).
If there is no photo, instead of approved you will see rejected and below in Approval notes the reason this listing was rejected.
Rejected means no reservation can be made for this listing.
You can also make the listing unavailable, but it will still be managed through hoteliga.
Unavailable is equivalent to a closed property.


Now, from your hoteliga domain, you can manage the AirBnb listing.

Set up the AirBnb Channel

After connecting a listing, an associated record in channels (Options ⇒ Channel Manager ⇒ Channels) will be created:

Airbnb Channels en.png

When you disconnect a listing, the associated record will be deleted from channels.


Click on the newly created channel.

  • Title – here, you can change the channel's title.
  • Channel property ID – is the associated listing ID
  • account_id – the host's ID (AirBnb account ID)
  • inventory_count – should be 0 or 1 depending on the available rooms inside the related room type in hoteliga:
    • 0 – means that the mapped hoteliga room type has only one room and AirBnb will be updated if the room type is available or not
    • 1 – means that the mapped hoteliga room type has more than one rooms and AirBnb will be updated with how many rooms are available
  • include_commission – should be 0 or 1:
    • 0 – means that the Airbnb commission will not be calculated in the agreed price of the reservation
    • 1 – means that the Airbnb commission will be calculated in the agreed price of the reservation

Airbnb channel en.png


For this channel, the ”room types” mapping is, also, completed automatically. Here, you could change the mapped room type, if needed:

Airbnb room type mapping en.png

Finally, you need to map rates inside “Price list” tab.

Airbnb map rates en.png

For Airbnb, there is only one rate.

Create a contract

After successfully connecting a listing to hoteliga, you need to:

  • create a booking agency for Airbnb (Options > Settings > Agencies > New Agency) and
  • a price list (Options > Settings > Pricing Policy > Pricelists > New Pricelist),

if they are not created already.

Then you can create the contract for the newly created Airbnb channel (Options > Settings > Agencies > Contracts > New Contract).

Airbnb contract new.png Airbnb contract new1.png

Upload the available rooms

From the tab "Rooms", inside the contract, you need to set your sales target and click “Save”, so that Airbnb gets updated with the current room availability.

Airbnb sales target.png

Upload the prices

From the tab "Price list", inside the contract, you need to Upload the prices to Airbnb.

Airbnb upload prices.png

Compare availability & prices

Once you complete the steps above, please double-check your availability and prices in Airbnb to make sure that everything was done correctly.


Set Prices

After properly connecting the listings, in the Airbnb (Official) area you should be able to see one line for each listing with the following tabs:

  • Set Prices
  • Set Restrictions
  • Clear Restrictions

Airbnb listing tabs.png

From the Set Prices modal, you are able to define several special and extra charges:

Airbnb set prices.png

Airbnb set prices1.png

Important: Make sure that the Default Daily Price corresponds to the listing's overnight value. Airbnb applies the Default Daily Price whenever prices are not updated and availability is open.

Set Retrictions

From the Set Restrictions modal, you can set various restrictions in the tab Global Settings and restrictions for a specific period in the tab Options.

Airbnb set restrictions.png

Airbnb set restrictions1.png

Default min nights: Minimum Stay. Note: Airbnb uses only Minimum Stay Arrival.

Default max nights: Maximum duration of a reservation.

Min hours ahead: The minimum number of hours between the booking time and the check-in time.

Allow request to book: Allow guests to send reservation requests.

Max days ahead: The maximum number of days between the booking date and the check-in date.

  • Select 0 to make ALL future dates Unavailable.
  • Select -1 to make ALL the future dates Available

Preparation time: The number of days to be blocked before and after a reservation.

Check-in days: Days of the week that check-in is possible.

Check-out days: Days of the week that check-out is possible.

Min nights for check in on: Minimum stay arrival based on each day of the week.

Clear Restrictions

From the Clear Restrictions modal, you can remove all previously defined restrictions. By doing so, the default restrictions will apply.

Airbnb clear restrictions.png

Seasonal Rules

Seasonal Rules are pricing and/or availability rules that are created on account level and can be applied for a specific time period over listings.

In order to review the existing seasonal rules, for all authorized accounts, select "Seasonal Rules" (Channel Manager => Seasonal Rules).

Airbnb seasonal rules review.png

Create a Seasonal Rule (Availability/Pricing)

From Options > Channel Manager > Airbnb > Seasonal Rules select the "New Seasonal Rule".

In the modal that will open, the minimum required fields are a title and the e-mail of the account to which the new rule will be added.

Note that seasonal rules can apply only to listings of the specific account.

"Rule id" can not be selected or modified, since it is determined from Airbnb.

Airbnb new seasonal rule 1.png

Airbnb new seasonal rule 2.png


  • Title - is the selected naming of the seasonal rule
  • Rule id - can not be selected or modified, since it is a unique identifier determined from Airbnb.
  • Color - select the color that will be applied to the days that this rule is applied to (calendar in Airbnb page)
  • E-mail - the e-mail of the account for which the rule will be created
  • Pricing Rules
    • Seasonal adjustment - a percentage or fixed amount applied to the base nightly price (daily or custom price)
    • Length-of-stay adjustment - a percentage or fixed amount applied to the adjusted seasonal price if they stay a specified length of time
    • Last-minute discount - modify the adjusted seasonal price by a percentage or fixed amount if guests book within a specified date/time of their stay
    • Booking-ahead discount - deduct a percentage or fixed amount from the adjusted seasonal price if they book before a specified date/time before their stay
  • Availability Rules
    • Closed on arrival - days of the week when guests cannot check-in
    • Closed on departure - days of the week when guests cannot check-out
    • Max nights - for each day of the week, the maximum nights guests can stay if they check-in on that day
    • Min nights - for each day of the week, the minimum nights guests can stay if they check-in on that day

When adding pricing rule(s), remember to click on the "Add" button so that it is added.

After creating the desired pricing and/or availability rules click on "Save".

Update a Seasonal Rule

Select the desired rule and apply the desired modifications.

"Rule id" and "E-mail" fields can not be updated.

After applying changes click on "Save".

Delete a Seasonal Rule

Select the desired rule and click on the "Delete" button.

Apply a Seasonal Rule

In order to apply a Seasonal Rule, go from Options > Channel Manager > Airbnb > Listings, select the listing you want and go to the tab Seasonal Rules. There select one from the "Title" dropdown menu, define the period for which you want to apply the rule and click "Add".

Airbnb apply rule.png


The same rule can be applied for different time periods.
If applying multiple rules for the same time period, the latest one will take effect.


In order to remove an applied Seasonal Rules, select the desired time period and click on "Delete" button.

Airbnb remove rule.png


In order to review the applied seasonal rules on a listing, select the desired listing from listings' list (Channel Manager ⇒ Listings).

In the modal, select the “Seasonal Rules” tab. Here you can review, which rule and over which time period(s) is applied.

Airbnb applied rules.png

Getting Prices from AirBnb

Navigate to available listings (Channel Manager ⇒ Listings) and select a connected listing.

Selecting "Get Prices" will retrieve the prices that are set for this listing for the next two(2) years and will update accordingly the related hoteliga price list.

In order to use this feature, it is required that listing is connected and there is already a contract for the related channel.

Airbnb get prices en.png

Getting Reservations from AirBnb

Navigate to available listings (Channel Manager ⇒ Listings) and select a connected listing.

Selecting "Get Reservations" will retrieve and register in hoteliga all future reservations made for this listing.

Airbnb get reservations.png