Changes

This page explains how to connect a PMS or OTA to the Beds24 API Version 1 for Channel Management

__Toc__

To better understand the operation of Beds24 it is good to start by setting up a test property including prices and other data you will be using manually in the Beds24 control panel.

See the notes at each endpoint for more information.

Create an API Key for your Beds24 account at Settings > Account > Account Access

The JSON API functions are recommended https://api.beds24.com

Use JSON createProperties to create properties and their rooms via API.

Descriptive content can optionally be added to a property and it's rooms with JSON setPropertyContent

Prices are defined in up to 16 daily price rows per room type.

We recommend using only Daily Prices for this type of connection.

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.

There is no need to send bookings to Beds24, it is better to manage inventory by setting number of rooms available with JSON setRoomDates

Make sure to adjust your inventory levels to account for the channel booking in Beds24.

When a booking is created, modified or cancelled by a channel, we will send a notification push to a URL specified by you.

The notify push expects an HTTP 200 response and will retry after a delay if this is not received.

Booking can be read with JSON getBookings by specifying the booking number from the notify push.

This will allow you to check for any bookings which are new or modified where the notify push was missed.

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.

Use JSON getProperties to retrieve properties and their rooms via API.

The OTA channel can be used to connect an OTA to Beds24.

It functions like any other OTA connected to the Beds24 channel manager.