Your overnight Planyo resources become properties, and every reservation gets a guide built from your own booking form
Planyo is a general online booking system. The same site might take bookings for apartments, kayaks, bikes and meeting rooms, and everything bookable is a “resource”. BetterSTR imports only your overnight resources and treats each one as a property with its own guide, so your property list doesn't fill up with boats. Because Planyo lets you add your own resource properties and booking form questions, the details you already collect, such as a parking bay or expected arrival time, can appear in the guide automatically.
Learn About Planyo Start Free Guidebook
Planyo isn't built only for holiday rentals, so it holds less property detail than a rental PMS. Expect to fill a few things in once in BetterSTR after the first sync.
| Data | Synced? | Notes |
|---|---|---|
| Resources (as properties) | Yes | Overnight resources only, with name, photos, currency and your site's timezone. If a site has no overnight resources, all of them are imported. |
| Address and map pin | Partial | Planyo stores one address per site, so every resource starts with the same pin. Set each one under Map Settings, Override Address. |
| Bedrooms, capacity, WiFi and description | Partial | Only if you have created custom resource properties with matching names, such as bedrooms or wifi_password. Otherwise add them in BetterSTR. |
| Check-in and check-out times | Partial | Planyo records night stays as whole days, so BetterSTR uses 3pm and 11am unless a check_in_time custom property says otherwise. You can set your own times on each property, or for every property in Property Defaults. |
| Bookings | Yes | Dates, the assigned unit, price, amount paid and the booking source. Cancelled, auto-cancelled and no-show bookings are marked cancelled. |
| Guest name, email and phone | Yes | Including the phone country code Planyo stores separately. |
| Party size | Partial | Planyo's quantity counts units, not people, so guest numbers are added up from booking form questions about adults, children or guests. |
| Booking form answers and guest notes | Yes | Every answer becomes a shortcode you can use in the guide. |
| Amenities and door codes | No | Planyo doesn't hold these. Add them in the BetterSTR guide builder. |
As site administrator, open Site settings, Integration & API, API key. A metasite key covers every site under that metasite.
Fill in the Planyo API Key field. The Hash Key field stays empty unless you have switched on hash key protection in Planyo.
Resources import first. Each one you switch on in BetterSTR queues its own booking backfill, covering stays from two days ago to two years ahead.
When you connect, BetterSTR adds its own notification callbacks to your Planyo site for new, confirmed, modified and cancelled bookings, plus check-ins, check-outs and no-shows. Each notification prompts BetterSTR to fetch that reservation from Planyo, so changes usually arrive within a minute or so. Once an hour BetterSTR also asks Planyo for anything modified since its last check, in case a notification was missed. Resource details are only refreshed daily or when you click Sync Properties, because Planyo has no notification for resource edits.
Planyo allows several callbacks per event and offers a form that clears every callback for an event at once. BetterSTR never uses it. On disconnect it removes only its own callback address, so any Zapier, accounting or door lock callbacks you rely on are left in place.
The guide builder gets Planyo Fields and Planyo Res menus. The custom ones are built from your own Planyo setup:
{{planyo_prop_…}}, for example {{planyo_prop_parking_bay}}.{{planyo_form_…}}, for example {{planyo_form_arrival_time}}.{{planyo_resource_name}}, {{planyo_site_name}}, {{planyo_site_address}}, {{planyo_site_phone}}, {{planyo_site_email}}, {{planyo_currency}}{{planyo_reservation_id}}, {{planyo_unit_assignment}}, {{planyo_guest_notes}}, {{planyo_total_price}}, {{planyo_amount_paid}}, {{planyo_booking_source}}Your custom resource properties are also passed to the Generate with AI tool, so a drafted guide uses your real details. The finished guide can play on an Android TV in the unit too.
Your accommodation resources, your booking form answers, one guide per stay.
Integration included
Resources only
As shortcodes
No credit card required. SMS and other add-ons are optional.
Read about pricing and add-ons, or see the full integrations directory.
No. BetterSTR only imports overnight resources, so equipment, tours and rooms booked by the hour stay out of your property list. If an accommodation resource is missing, check it is marked as an overnight stay in Planyo, then click Sync Properties.
Planyo stores the address once per site, not per resource. Set each property's real address and map pin in BetterSTR under Map Settings, Override Address. Nothing overwrites it afterwards.
No. BetterSTR adds its own callbacks next to yours and, when you disconnect, removes only its own address. It never uses Planyo's option to clear every callback for an event.
Yes. Each booking form question becomes a planyo_form shortcode, and each custom resource property becomes a planyo_prop shortcode, filled in per booking when the guest opens their guide.
Check the whole key was copied. If the key is restricted, allow the IP address 103.162.49.19 and the API methods listed on the Planyo connect page in BetterSTR, then try again.