ThinkReservations integration

Connects to the ThinkReservations External API with a per-hotel Restricted API key. Read-only availability, rates, inventory, rooms, and policies; booking is a hand-off to the property's booking engine. ThinkReservations official site ↗

ARI only. Maison reads availability, rates, inventory, and policies. Reservations are not created or looked up in chat.

Supported features

Every call goes to the hotel named by the key. Availability is asked for a check-in and check-out date with the party size (adults, children with ages, pets) and an optional promotion code the property has published; prices are quotes at search time. Whether a unit is a room or a room type depends on how the property sells.

Feature	Supported	Notes
Hotel availability	✓	Per bookable unit and rate type for a stay: price, fees, taxes, total, deposit, per-night prices, and the rate's booking restrictions
Room types	✓	Room types and rooms with occupancy, pet and extra-guest fees, bedrooms, and accessibility
Room rates	✓	Rate types with deposit rules, and daily prices with minimum-stay and closed dates
Inventory calendar	✓	Rooms left to sell per room type per night, for 'when do you next have space?'
Hotel details and policies	✓	Address, contact, website, currency, and the cancellation policy as written by the property
Promotions and blackouts	✓	Operator-only reads, off by default
List / get reservations	—	Not part of the 1.0 scope — guests are directed to the property
Create reservation	—	Booking is a hand-off to the property's booking engine
Payment link	—

Setup steps

Generate a Restricted API key in ThinkReservations
The property signs in to ThinkReservations and opens Settings → API keys (manage.thinkreservations.com/settings/api-keys). Create a key with the read scopes Maison uses: read:availability, read:rate, read:room, and read:hotel. Copy the key (it starts with rk_live_, or rk_test_ for a test property) and note the hotel ID shown beside it.
A key's scopes are fixed when it is created. Maison never needs write:reservation, write:rate, or read:customer; leave them off.
Create the integration in the business console
Open the business console, select the client, and go to Settings → Integrations. Choose Add integration, type Property Management System, provider ThinkReservations. Paste the Restricted API key and the hotel ID, select the tool access, then click Save.
Test it
Ask the concierge for a room on a near-future date. A list of units with prices confirms the property is connected. A "could not authenticate" answer means the key or the hotel ID is wrong; an empty answer on dates the property has open usually means the key is missing the read:availability scope.

Available tools

9 tools are available for ThinkReservations. The concierge calls them on a guest's behalf during a conversation; which are enabled is set per property, so you only turn on what you want it to be able to do.

Enabled by default (7)

On as soon as the integration is connected, with nothing else to configure.

Tool	What it does
`thinkreservations_get_availability`	Check which units (rooms) are available for a stay and what each costs — THE tool for 'do you have rooms for…', 'any availability this weekend?', and 'how much is a room from… to…'. start_date = check-in, end_date = check-out, both YYYY-MM-DD. Every unit lists its bookable rate types with the stay price, fees, taxes, total, deposit, and per-night prices. Quote the total as the stay price and name the currency from the hotel tool. The hotel is pre-configured — never guess or invent a hotel id. An empty units list means NO availability for those dates — not an error; say so and suggest other dates instead of retrying. If a rate carries a restriction such as MINIMUM_NIGHTS_ON_ARRIVAL, tell the guest about the minimum stay. Pass the party size the guest states (adults, children with ages, pets) so unsuitable units are filtered out, and a promotion code only if the guest gives one. Booking is not available through chat — guide the guest to the property's booking link with the unit and rate you quoted.
`thinkreservations_get_daily_rates`	Get the nightly price and stay rules for ONE rate type across a date range, per room type: price per night, minimum and maximum nights on arrival or through the stay, closed-on-arrival, closed-on-departure, and stop-sell. rate_type_id is REQUIRED — take it from the rate types tool; never guess it. Dates in YYYY-MM-DD. Use the rules to explain why a stay cannot start or end on a date. For a full stay quote use the availability tool.
`thinkreservations_get_hotel`	Retrieve the property's details — name, address, phone, email, website, time zone, currency, and its cancellation policy as written by the property. Use it for 'where are you?', 'what currency?', and 'what is your cancellation policy?'. The hotel is pre-configured.
`thinkreservations_get_inventory`	Get how many rooms are left to sell per room type per night across a date range — a calendar view for 'when do you next have space?' or 'which nights in October are open?'. Dates in YYYY-MM-DD. It carries no prices: once the guest picks dates, use the availability tool to quote. Zero rooms to sell on a night means that night is not available.
`thinkreservations_get_rate_types`	List the property's rate types — name, code, description, minimum and maximum nights, deposit rule, and the room types each applies to. Use it for 'what rates do you offer?' and to obtain a rate type id for the daily rates tool. For a priced quote of an actual stay use the availability tool.
`thinkreservations_get_room_types`	List the property's room types (id and name). Use the ids to narrow the daily rates and inventory tools to one room type. For room details such as occupancy, fees, and bedrooms use the rooms tool.
`thinkreservations_get_rooms`	List the property's rooms with a short description, maximum guests, adult and child occupancy, pets allowed, and the extra-guest, pet, and cleaning fees. Use it for 'do you allow pets?', 'how many can sleep in…?', or to describe a room. For availability and prices on dates use the availability tool. Ignore rooms marked inactive or doNotSellOnline when recommending.

Available on request (2)

Off by default. Ask Maison to enable any of these for your property — several change data in your ThinkReservations account, so they are opt-in rather than assumed.

Tool	What it does
`thinkreservations_get_blackouts`	OPERATOR-GRADE: never use in guest conversations unless explicitly instructed. List blackouts in a date range — rooms taken out of sale with the dates covered, the blackout type, and staff notes. Dates in YYYY-MM-DD.
`thinkreservations_get_promotions`	OPERATOR-GRADE: never use in guest conversations unless explicitly instructed. List the property's promotions — name, description, promotional code, minimum and maximum nights, target channel, and the discount (what it applies to, percent or amount). Includes codes the property may not have published; do not read codes out to guests.