Skip to main content
RecepAI needs to know who is staying in your hotel right now — which guests are in which rooms, their names, their stay dates and, where you hold them, their contact details. Your property management system already has that list. A PMS integration keeps RecepAI’s copy in step with it, so your desk does not have to enter a guest twice. There are two ways to connect. They reach the same result; they differ in who does the work, and where.

​
The two methods

Your PMS sends to RecepAI

Your PMS vendor calls RecepAI’s PMS API whenever a guest checks in, moves room or checks out. Your vendor builds and maintains the connection on their side, against this reference.

RecepAI reads your PMS

Hotel Linkage connects to your PMS’s read interface and keeps the guest list in step by reading it on a schedule. Hotel Linkage does the set-up and the connection work; your vendor provides access, documentation and support on the PMS side.

​
Which one to choose

The first method gives you the fastest updates and is the right choice when your PMS vendor offers, or is willing to build, an integration with RecepAI. The second method is assessed case by case: Hotel Linkage reviews your PMS’s read interface against the listed conditions and confirms whether, and how, it can be connected.
Whichever method you choose, RecepAI only ever reads guest information from your PMS. It never writes to your PMS.

​
What RecepAI does with the guest list

1

The guest list arrives

Either your PMS sends each event, or RecepAI reads the current in-house list.
2

RecepAI keeps its roster in step

Guests appear on Active Guests as they arrive and leave it as they depart, with the room your PMS holds for them.
3

Your guests can hear from you

Where your hotel has them switched on, a guest can receive a welcome message and your feedback requests during and after the stay.
4

Your AI staff use it

When a guest contacts the hotel by chat, voice or messaging, Recep can confirm their room before fulfilling a request such as extra towels, room service or a late checkout.
5

Your team sees it

Arrivals, departures and room changes appear on the Front Desk screens without anyone entering them.

​
Method 1: your PMS sends to RecepAI

​
Base URL

Replace {slug} with the hotel’s unique identifier. You receive this alongside your API key during onboarding.
What is {slug}?Each hotel on RecepAI has a unique slug — a short, URL-safe identifier like grand-hotel or seaside-resort. The hotel administrator will provide this to you along with the API key. It appears in every endpoint URL.Example: For “Grand Hotel Istanbul” with slug grand-hotel, the check-in endpoint is:

​
What you’ll need

​
Available endpoints

Authentication

API key format, Bearer tokens, and key management.

Quick Start

Send your first guest check-in.

​
Method 2: RecepAI reads your PMS

Hotel Linkage assesses your PMS’s read interface against the conditions on the next page, and sets the connection up with you once they are met. Your part is to provide read access and the information listed there.

RecepAI reads your PMS

Access we need, the fields the guest list must carry, the reservation status and change information we require, what we do not keep, and how the connection goes live.