--- title: GuestPoint API Integration on Truto slug: guestpoint category: Travel canonical: "https://truto.one/integrations/detail/guestpoint/" --- # GuestPoint API Integration on Truto **Category:** Travel **Status:** Generally available ## MCP-ready AI tools Truto exposes 9 tools for GuestPoint that AI agents can call directly. - **list_all_guest_point_pings** — Ping the guestpost API to test connectivity and verify that authentication is working. Returns: Version, Message. Takes no required parameters. - **list_all_guest_point_currencies** — List all currencies available in guestpost for approximate price display in the booking engine. Returns: Code, Name, Symbol, Rate, LastRateUpdate. - **get_single_guest_point_currency_by_id** — Get a single guestpost currency by its currency code. Returns: Code, Name, Symbol, Rate, LastRateUpdate. Required: id. - **list_all_guest_point_exchangerates** — Get the current exchange rate between two currencies in guestpost. Returns: Code, Name, Symbol, Rate, LastRateUpdate. Required: from_currency, to_currency. - **list_all_guest_point_properties_availabilities** — List availability and rate data for a GuestPoint property for the specified dates and occupancy. Returns property details and, for each room type, per-night Availabilities, UrgencyMessages, and RatePlans with nightly SellRate and StrikeOutRate. Returns: Id, Name, Description, CurrencyCode, StreetAddress, Country, RoomTypes, PropertyImages, Messages, Contact, Facilities, Latitude, Longitude,… - **create_a_guest_point_properties_extra** — Retrieve eligible extras and addons available in guestpost for the selected dates and room/rate combinations. Returns: Id, Name, Description, ExtraType, CheckoutType, MaxItems, PriceType, DisplayOrder, Images, Prices. Required: property_id, RoomStays. - **create_a_guest_point_properties_reservation** — Create a reservation in GuestPoint for a property's channel. Returns: ID, PropertyId, ChannelCode, SalesChannelCode, CurrencyCode, Status, SaleTime, ReceivedTime, DeliveredToPMS, ExtraInfo, ConfNum, Adults, Children, ReservationTotal, DepositAmount, RoomStays, Guests, PaymentRequired, VerificationCode. Required: property_id, PropertyId, CurrencyCode, Adults, ConfNum, VerificationCode, RoomStays,… - **update_a_guest_point_properties_reservation_by_id** — Validate a GuestPoint reservation to confirm availability and calculate final pricing before booking. Returns: PropertyId, ChannelCode, SalesChannelCode, CurrencyCode, Status, SaleTime, ReceivedTime, ExtraInfo, Adults, Children, ReservationTotal, DepositAmount, RoomStays, Guests, PaymentRequired, VerificationCode, ConfNum, ID. Required: property_id, PropertyId, CurrencyCode, Adults, RoomStays.… - **list_all_guest_point_properties_bestavailablerates** — List best available rates for a guestpost property across a date range, returning the cheapest rate for each day. Returns: PropertyId, PropertyName, RoomTypeId, RoomTypeName, RatingType, Rating, Images, Days. Required: property_id, from_date, to_date. ## How it works 1. **Link your customer's GuestPoint account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach GuestPoint.** The Proxy API is a 1-to-1 mapping of the GuestPoint API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Power direct booking engines for independent hoteliers** — Website builders and booking widget SaaS can pull live availability, best available rates, and currency data from GuestPoint to display accurate pricing, then commit confirmed reservations directly to the property's PMS. - **Automate pre-arrival upselling and ancillary revenue** — Guest experience platforms can fetch upcoming reservations, surface eligible extras like late checkout or breakfast based on room type and dates, then update the reservation with the chosen add-ons and recalculated balance. - **Distribute inventory to regional OTAs and niche channels** — Travel aggregators can read real-time availability from GuestPoint and write new reservations back with payment verification codes, eliminating manual extranet updates and preventing double-bookings. - **Feed dynamic pricing and revenue management engines** — Revenue management SaaS can pull current availability, rate plans, and best available rates from GuestPoint to feed pricing algorithms that recommend optimized rates for hoteliers. - **Validate bookings for payment and fintech workflows** — Payment processors can confirm reservation details, apply multi-currency conversion using live GuestPoint exchange rates, and record verification codes against the booking once a transaction clears. ## What you can build - **Real-time availability and rate widgets** — Display live per-night availability, sell rates, and strike-out pricing pulled directly from GuestPoint property availability data. - **End-to-end reservation creation flow** — Capture guest details, adult/child counts, room stays, and deposit amounts, then commit confirmed bookings into the hotelier's GuestPoint instance. - **Reservation modification and rebooking** — Update existing reservations to add extras, adjust stays, or apply payment verification codes without leaving your product. - **Dynamic upsell catalog for extras** — Surface eligible add-ons like breakfast, parking, or late checkout based on the specific reservation's dates and room type, with max item limits and pricing types. - **Localized multi-currency checkout** — Use GuestPoint's supported currencies and live exchange rates to render prices in the traveler's local currency without depending on third-party FX feeds. - **Best available rate marketing tiles** — Pull the cheapest daily rate across a date range to power 'from $X/night' marketing modules and price comparison views. ## FAQs ### How does authentication work for GuestPoint connections? Truto handles the credential exchange and token storage for GuestPoint on behalf of your end users, so your app never touches raw credentials. Your users connect their property through a Truto-managed auth flow and you call the integration with a single Truto connection ID. ### What GuestPoint operations are available today? The current toolset covers reading property availability, currencies, exchange rates, best available rates, and pings, plus creating extras, creating reservations, and updating reservations by ID. Additional endpoints can be added on request. ### Can I prevent double-bookings when writing reservations? Yes. The typical pattern is to validate against list_all_guest_point_properties_availabilities immediately before calling create_a_guest_point_properties_reservation, and to use update_a_guest_point_properties_reservation_by_id to confirm pricing and inventory before committing payment. ### Is there a Unified API for GuestPoint? Not yet. GuestPoint is currently available as a passthrough integration with normalized tools, so you call the native endpoints through Truto without managing GuestPoint-specific auth, pagination, or quirks. ### How do I handle multi-currency pricing? Use list_all_guest_point_currencies and get_single_guest_point_currency_by_id for supported currency metadata, and list_all_guest_point_exchangerates for live conversion rates sourced directly from the property's PMS. ### How fresh is the availability and rate data? Availability, rate plans, and best available rates are queried live from GuestPoint at request time, so you always get the property's current state rather than a cached snapshot.