Support
Reach our developer team about anything that blocks your integration. We suggest checking the product’s Error codes page first; most questions are answered there.
Technical questions, bug reports, partner key and test hotel requests. Answered within one business day.
Partner key
Access requires a partner account issued by HMS. E-mail us your company details and the hotels you will integrate; you will receive an apiKey, apiSecret and a hotel ID for the test environment.
When reporting a problem, include
- Product and endpoint (e.g. Online Booking ·
POST /external/online/roomType) - The full request body and response, with
apiSecret, token and card data masked - When the request was sent (with time zone) and the
hotelID - What you expected and whether the problem is reproducible
Frequently asked questions
What do I need to use the API?
A partner account issued by HMS (apiKey / apiSecret) and authorisation for the hotel you integrate. The relevant module (e.g. the online booking channel) must be active on the hotel side.
Is there a test environment?
Yes. The examples in these docs use the test environment (test.hms.gen.tr); a hotel record and partner key for it are provided for development. The production address and keys are issued once the integration is approved.
I get a 401.
The token is missing, expired, lacks the Bearer prefix or belongs to another hotel. Log in again and retry. If login returns success: false, check message: wrong key pair or no hotel authorisation.
The room list is empty or roomCount is 0.
The hotel’s online channel is closed (errorCode 10003), no room type is open for sale (10004) or date/occupancy restrictions apply. For rooms with roomCount 0, roomRestrictionMessage gives the reason (minimum stay, closed to check-in, no rate defined).
I pushed a booking but it does not show in the panel.
Check for Error in BookingPushRS. Hotel registration not found on HMS. means the hotel is not linked to the online channel; Could not register. usually means an invalid roomTypeID / ratePlanID or inconsistent dates.
When will the other modules’ APIs be published?
Hotspot, Restaurant POS, Spa, AI, TV and PBX documentation is being added in turn. Release dates are announced in the changelog; write to us for early access to a specific module.