Facebook Tracking Pixel

Digital Guidebooks for Planyo

Your overnight Planyo resources become properties, and every reservation gets a guide built from your own booking form

BetterSTR
INTEGRATION
Online Booking System

For Planyo sites that rent out accommodation

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
Digital Guestbook Preview

What syncs from Planyo

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.

DataSynced?Notes
Resources (as properties)YesOvernight 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 pinPartialPlanyo 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 descriptionPartialOnly 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 timesPartialPlanyo 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.
BookingsYesDates, the assigned unit, price, amount paid and the booking source. Cancelled, auto-cancelled and no-show bookings are marked cancelled.
Guest name, email and phoneYesIncluding the phone country code Planyo stores separately.
Party sizePartialPlanyo'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 notesYesEvery answer becomes a shortcode you can use in the guide.
Amenities and door codesNoPlanyo doesn't hold these. Add them in the BetterSTR guide builder.

How the Planyo connection works

1

Copy your API key

As site administrator, open Site settings, Integration & API, API key. A metasite key covers every site under that metasite.

2

Paste it, plus a hash key if used

Fill in the Planyo API Key field. The Hash Key field stays empty unless you have switched on hash key protection in Planyo.

3

Enable your properties

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.

Planyo notifications, added alongside yours

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.

Good to know

  • The guide link is added as a line in the booking's private admin notes. Your own notes are kept, and guests can't see admin notes, so send the guide with BetterSTR's SMS or email.
  • If your key is limited by IP address, allow 103.162.49.19. If it is limited by method, the connect page lists the methods BetterSTR needs.
  • Planyo asks partners to make one API call at a time per key, so a large first import runs steadily rather than all at once.
  • Use Full Sync on the Planyo page to pull older stays.

Planyo shortcodes in your guide

The guide builder gets Planyo Fields and Planyo Res menus. The custom ones are built from your own Planyo setup:

  • Your resource properties: each custom resource property becomes {{planyo_prop_…}}, for example {{planyo_prop_parking_bay}}.
  • Your booking form: each question becomes {{planyo_form_…}}, for example {{planyo_form_arrival_time}}.
  • Site and resource: {{planyo_resource_name}}, {{planyo_site_name}}, {{planyo_site_address}}, {{planyo_site_phone}}, {{planyo_site_email}}, {{planyo_currency}}
  • Reservation: {{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.

Connect your Planyo site

Your accommodation resources, your booking form answers, one guide per stay.

Free plan

Integration included

Overnight

Resources only

Your fields

As shortcodes

Start Your Free Guidebook See Pricing

No credit card required. SMS and other add-ons are optional.

Integration Partner

Visit Planyo.com

Planyo setup help

Planyo questions

My Planyo site also rents bikes and boats. Will they show up?

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.

Why do all my properties show the same address?

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.

Will connecting BetterSTR affect my other Planyo notification callbacks?

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.

Can my booking form questions appear in the guide?

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.

Planyo says Invalid method or API key. What now?

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.