PMSs: How to connect to Beds24 and use Booking.com via API V2

PMSs: How to connect to Beds24 and use Booking.com via API V2

This page explains how PMSs can develop API connectivity with Booking.com

1 Use case

You are a PMS, Property Management Company, or similar, and want to offer your customers connectivity with Booking.com via Beds24 without them having to log into Beds24.

Your developer develops the integration between your system and Beds24.

2 Overview

With an API based connectivity solution for Booking.com, logging in to Beds24 for setup and booking management is generally not required. Most actions and functions can be used via API. If required this function is available as white label option.

3 The Basics

It is a good idea to get a basic understanding of how Beds24 works.

We recommend going through this introduction and creating a test property with prices and any data you intend to use.

4 The API

4.1 API Versions

Beds24 has two API versions, V1 and V2, we recommend using V2 for any new projects.

Documentation for API V2 is available here.

There is also interactive Swagger documentation. We recommend using Swagger to try the examples in this guide.

4.2 API V2 Authentication

API V2 uses refresh tokens which generate access tokens, these tokens will be included as headers in your requests in this format: "token: {token}"

To obtain a refresh token, first go the API page in the control panel and click the generate invite code button. Select the scopes you require then click the generate invite code button. You will now see an invite code on this page, you can copy this to your clipboard and use the GET /authentication/setup endpoint to exchange your invite code for a refresh token.

Request:

curl -X 'GET' \ 'https://beds24.com/api/v2/authentication/setup' \ -H 'accept: application/json' \ -H 'code: abc123'

Response:

{
  "token": "qEK5L...",
  "expiresIn": 86400,
  "refreshToken": "iexTC..."
}

In the above example, "token" is a short term access token that you will use to authenticate other API calls, "expiresIn" is how many seconds the token will last, finally you can use "refreshToken" to generate more tokens in the future.

Try making an invite code and exchanging it for a refresh token yourself with our Swagger page

4.3 Property Creation in Beds24

You can create your Beds24 properties using the POST /properties endpoint.

Try creating a very basic property with this request

[
  {
    "name": "Luxury Hotel",
    "propertyType": "hotel",
    "currency": "USD"
  }
]

If successful, you should be able to see this new property in the control panel

In Swagger, try clicking the "schema" under POST /properties to see all the fields you can set using this endpoint.

Your property will also need a room, you can add a new room to an existing property through POST /properties. To do this you will need the id of the property you created above, you can find this in the response to the request above, but you can also find this by using the GET /properties endpoint.

Add a new room to an existing property (replace 1234567 with the id of your property)

[
  {
    "id": 1234567,
    "roomTypes": [
      {
        "name": "Standard room"
      }
    ]
  }
]

4.4 Mapping

To update your Booking.com listings they need to be mapped to the corresponding room in Beds24.

Mapping to booking.com cannot be done via our API. Information about how to map using the control panel is available here

4.5 Bookings

Booking.com will send bookings to Beds24. You can either get them using the GET /bookings endpoint, have them sent to you via booking webhooks, or use a combination of the two.

4.6 Price and Availability Sync

Prices and availability can be updated using the POST /inventory/rooms/calendar endpoint. Try changing the price and minimum stay of a room:

[
  {
    "roomId": 1234567,
    "calendar": [
      {
        "from": "2025-01-01",
        "to": "2025-01-31",
        "minStay": 2,
        "price1": 150,
      }
    ]
  }
]

You can visit the calendar page in the control panel to see these changes, or you can use the GET /inventory/rooms/calendar endpoint.

As always, you can click the schema button in the Swagger endpoint to see what else you can change this way.

4.7 Messaging

Beds24 integrates with Booking.com's messaging API. If you wish you can message with guests via the POST /bookings/messages endpoint, or see existing messages using the GET /bookings/messages endpoint.

4.8 Reporting

You can report invalid credit cards, no-shows, changes in stay dates and guests misconduct to booking.com using the POST/channels/booking endpoint.

4.9 Reviews

You can read Booking.com reviews using the GET /channels/booking/reviews endpoint.

4.10 White Label

Start a support ticket via the SUPPORT button on the top of your Beds24 account if you are interested in a white label option.