Digital Guidebooks for Guesty
Guesty Open API credentials bring your whole portfolio into BetterSTR, one guide per reservation
INTEGRATION
Guesty Open API credentials bring your whole portfolio into BetterSTR, one guide per reservation
Guesty is aimed at professional managers with large, multi-city portfolios, and its Open API is how outside tools plug in. BetterSTR connects through that API with a client ID and secret, imports every listing in the account, and keeps reservations current through Guesty webhooks. Because Guesty stores each listing's time zone, arrival and departure times in your guides are shown in the property's local time, even when your portfolio spans several regions.
Learn About Guesty Start Free Guidebook
Listings and reservations come across through the Guesty Open API. A few listing details aren't requested yet, so you add those once in BetterSTR.
| Data | Synced? | Notes |
|---|---|---|
| Listings | Yes | Name or nickname, address, map position, bedrooms, bathrooms, beds and guest capacity. |
| Time zone and default times | Yes | Each listing's time zone plus its default check-in and check-out times. Reservation times are converted to local time. |
| Reservations | Yes | Confirmed, inquiry, awaiting payment, checked-in and cancelled reservations. Owner blocks are skipped. |
| Guest name, phone and email | Yes | When Guesty includes them on the reservation's guest record. |
| Party size and source | Partial | Total guest count and the booking source. No adults, children or pets split. |
| Listing photos | Partial | The listing's main picture. Add a gallery in BetterSTR if you want more. |
| Descriptions and house rules | Yes | Summary, the space, guest access, house rules, neighbourhood and notes from the public description. |
| Amenities, currency, WiFi, door codes | No | Set these in BetterSTR. WiFi entered there also gives guests a WiFi QR code. |
| Booking links | No | Add your own direct or channel links in BetterSTR if you want them in the guide. |
In Guesty, open Integrations and then Open API, and add an application. Guesty gives you a Client ID and a Client Secret for it.
Log in to BetterSTR, open the Guesty integration and enter both values. BetterSTR requests a token from Guesty straight away to check they work.
Listings load, then one sweep pulls upcoming reservations across the whole account. Webhooks are registered in Guesty automatically.
BetterSTR subscribes to Guesty's reservation and listing webhooks. A new or changed reservation is saved as soon as Guesty sends it, normally within seconds, and Guesty's cancellations arrive as reservation updates. A listing update triggers a fresh listings sync. Guesty access tokens last 24 hours, and BetterSTR renews them on its own using your saved credentials, so you won't be asked to reconnect each day.
BetterSTR adds a reservation custom field called Guest Guidebook URL to your Guesty account and fills it with each guest's personal guide link. Use that field in a Guesty automated message and the right link goes to each guest.
{{guest_name}} and {{check_in_time}}, filled from Guesty data.For managers with many units, the same guide can also appear on an Android TV in each property.
Client ID and secret in, the whole portfolio across.
Client ID and Secret
Per listing time zone
Listings on the free plan
Free to start, no card required. Optional add-ons are billed only if you use them.
The Guesty sync is free, see pricing for paid extras. Other systems are on the integrations page.
In Guesty, go to Integrations, open the Open API section and create an application. Guesty then shows the Client ID and Client Secret for that application. If you can't see the Open API area, ask your Guesty account manager to enable it.
No. Guesty tokens expire after 24 hours, but BetterSTR requests a new one automatically using the Client ID and Secret you saved. You only need to re-enter them if you rotate or delete the secret in Guesty.
BetterSTR fills a reservation custom field in Guesty called Guest Guidebook URL. Add that field to a Guesty automated message and every guest receives the link to their own guide.
Yes. BetterSTR reads each listing's time zone from Guesty and converts reservation times to it, which helps when your portfolio covers more than one time zone.
The Guesty connection doesn't import amenities, WiFi or currency yet. Add them once per property in BetterSTR, and the WiFi details will also generate a QR code guests can scan to join.