Hotelumo API reference

Find public room offers for a stay

Returns sanitized room-type offers for the requested dates and occupancy. Prices and inventory are calculated by the server.

Request a room reservation

Revalidates the selected offer, then creates a REQUESTED reservation with one unassigned PENDING room for hotel staff to approve.

List daily rates

Reads per-day prices/inventory for a rate plan over a date window (the ARI surface). Pass hotelId, ratePlanId, dateFrom and dateTo. Requires the rates:read scope.

Upsert daily rates

Batch-upserts per-day prices/inventory (max 500 per call). Requires the rates:write scope.

List guests

Lists the guests of your organization, optionally filtered by hotelId, email or _ids. Requires the guests:read scope.

Create a guest

Requires the guests:write scope.

Get a guest

Returns a single guest by id. Guests belonging to another organization respond 404. Requires the guests:read scope.

Update a guest

Updates a guest by id. Guests belonging to another organization respond 404. Requires the guests:write scope.

Delete a guest

Deletes a guest by id. Guests belonging to another organization respond 404. Requires the guests:write scope.

List rate plans

Lists the rate plans for a hotel (pass hotelId). Rate plans are part of the ARI pricing surface, so this requires the rates:read scope.

Create or update a rate plan

Requires the rates:write scope.

List reservations

Lists the reservations of your organization. Optionally filter by hotelId, guestId, a legacy startTime/endTime window, or an overlapping stay window with stayDateFrom/stayDateTo. Requires the reservations:read scope.

Create a reservation

Creates a reservation (and its ReservationRooms from the rooms array). Requires the reservations:write scope.

Get a reservation

Returns a single reservation by id, with its rooms. Reservations belonging to another organization respond 404. Requires the reservations:read scope.

Update a reservation

Updates a reservation by id. Reservations belonging to another organization respond 404. Requires the reservations:write scope.

Delete a reservation

Deletes a reservation by id (cascading its rooms, folio and charges). Reservations belonging to another organization respond 404. Requires the reservations:write scope.

Approve a requested reservation

Rechecks inventory, promotes the parent to CONFIRMED and each PENDING room to CONFIRMED, then starts the normal folio/reminder workflow. Requires the reservations:write scope.

List rooms

Lists the physical rooms of your organization, optionally filtered by hotelId or roomTypeId. Requires the rooms:read scope.

Create a room

Requires the rooms:write scope.

List room types

Lists the room types of your organization, optionally filtered by hotelId. Room types are part of the physical inventory, so this requires the rooms:read scope.

Create a room type

Requires the rooms:write scope.

List webhook subscriptions

Webhook subscriptions deliver reservation.created, reservation.updated, reservation.deleted, guest.created, guest.updated and guest.deleted events to your server as signed POST requests (X-Hotelumo-Signature: t=<timestamp>,v1=<hex HMAC-SHA256 of "timestamp.body">). An endpoint failing 20 times in a row is disabled automatically. Subscriptions are managed with an operator access token; the secret is only returned once, on create.

Create a webhook subscription

The response includes the signing secret exactly once — store it; it cannot be retrieved again.

Update a webhook subscription

url, events and active are editable; the secret and hotel are immutable. Re-enabling an auto-disabled endpoint is done by setting active back to true.

Delete a webhook subscription