Connect PMS with API
This page explains how to connect a PMS to the Beds24 API for Channel Management
1 API setup
Create an API Key for your Beds24 account at Settings > Account > Account Access
For extra security also whitelabel your IP address to prevent access from unauthorized IP addresses.
Access to most API functions will require the API Key and the PROP Key for the property being accessed.
There are usage limits on the API so design your system to avoid unnecessary and minimize the frequency of API calls.
The JSON API functions are recommended https://api.beds24.com
2 Create Properties
Use JSON createProperties to create properties and their rooms via API.
Set a PROP Key for the property when creating it so it can be accessed later via API.
Once created, the property and it's rooms can be modified with JSON modifyProperty
3 Setup Price and Channel Mapping
Prices are defined in up to 16 daily price rows per room type.
Each row can be defined with an occupancy and minimum stay and sent to any combination of channels.
This means for each date can have up to 16 different prices for combinations of occupancy, minimum stay and channel.
4 Send Price and Availability
Price and availability can be set per room type with JSON setRoomDates
For each date, up to 16 prices, the number of rooms available, minimum stay (room level), maximum stay (room level) and check-in check-out restrictions can be sent.
Bookings from channels will import into Beds24 and automatically reduce the available inventory.
The Bookings should be left in Beds24 so modification/cancellation can be accepted.
Make sure to adjust your inventory levels to account for the channel booking in Beds24.
6 Booking Notification
The notify push expects an HTTP 200 response and will retry after a delay if this is not received.
7 Booking Detail
Booking can be read with JSON getBookings by specifying the booking number from the notify push.
We recommend periodically polling JSON getBookings (circa once per 30 minutes should be adequate) specifying the modifiedSince time as the time a few seconds before your last poll.
This will allow you to check for any bookings which are new or modified where the notify push was missed.
8 Booking Modification
If a booking is modified by a channel, you will receive a notify push and you can read the new booking detail.
It is up to your system to compare the new booking detail with the original and determine what actually changed.