BetterSTR connects directly to Smoobu so your properties and bookings sync automatically and every guest gets their own digital guidebook link. This guide walks you through creating your Smoobu API credentials, connecting them to BetterSTR, setting up the optional real-time webhook, sending the guide link from Smoobu, and what to check if something doesn’t look right.
Before you start
You need Smoobu API access
If you can’t see an API Keys section under Settings → Advanced in your Smoobu account, your Smoobu plan may not include API access. Contact Smoobu support and ask about it: without an API key and secret, the connection can’t be made. The BetterSTR side is free on every plan.
BetterSTR connects to one property management system at a time. If you’re already connected to another PMS, disconnect it first, otherwise the Smoobu page sends you back to your dashboard with a “one integration at a time” message.
Step 1: Create your Smoobu API key and secret
- Log in to Smoobu at login.smoobu.com.
- Open Settings → Advanced → API Keys.
- Click Create API Key and give it a label like “BetterSTR”.
- Click Generate Secret and copy both the key and the secret.
The secret is shown only once
Smoobu displays the API secret a single time when you generate it. If you lose it, don’t worry: just generate a new secret and reconnect. Smoobu’s older single “API Key” under Settings → Profile has been retired by Smoobu and won’t work here. You need the newer key and secret pair.
Step 2: Connect them to BetterSTR
- In BetterSTR, go to Integrations and choose Smoobu, or head straight to the Smoobu connection page.
- Paste the key into the API Key field (1) and the secret into the API Secret field (2), then click Connect Smoobu (3).
- BetterSTR checks the pair with Smoobu before saving it. Once it’s accepted, your properties sync straight away, then your current and upcoming bookings are imported in the background.

Step 3 (recommended): Turn on real-time updates
Smoobu can notify BetterSTR the moment a booking is created, changed or cancelled, but you need to tell Smoobu where to send those notifications. It’s a one-time step:
- On the Smoobu page in BetterSTR, find the Real-time updates card and click Copy (1) next to your personal webhook URL.
- In Smoobu, open Settings → Advanced → API and paste the URL into the Webhook URL field, then save.

That URL contains a private token unique to your account, so treat it like a password. If you skip this step the integration still works: BetterSTR checks Smoobu for booking changes every hour regardless, so the webhook simply makes updates arrive within moments instead of within the hour.
Step 4: Choose which properties get guidebooks
Your Smoobu apartments appear in the Properties list on the Smoobu page, switched on by default. Use the toggles (1) to choose which properties generate guidebooks for new bookings, then click Update Selected (2). When you switch a property on, its current and upcoming bookings are synced straight away.
The Sync menu on the left has the manual tools: Sync Properties, Sync Reservations (3) to pull current and upcoming bookings now, Full Sync to pull bookings from the last 10 years, and Reset %guidebook% to rewrite guide links. Use Update Credentials (4) when you rotate your Smoobu key and secret.

Sending the guide link from Smoobu
For every confirmed, upcoming booking, BetterSTR saves the guest’s personal guidebook link on the Smoobu booking as a custom placeholder called betterstr_guide. Add that placeholder to your Smoobu message templates (for example your pre-arrival message) and each guest receives their own link automatically. Cancelled and blocked bookings are skipped, and so are bookings whose arrival was more than three days ago.
What syncs, and how fast
- Properties: name, address, map location, time zone, bedrooms, beds, bathrooms, maximum occupancy and amenities. Property details refresh daily, or on demand with Sync Properties.
- Bookings: guest name, email, phone, party size, arrival and departure dates and times, prices and the booking channel (Airbnb, Booking.com, Vrbo, Expedia, direct). Bookings without a check-in or check-out time in Smoobu fall back to 15:00 and 11:00.
- Booking changes: near real-time via the webhook (Step 3), with an hourly sync as a safety net. Cancelled or deleted bookings are marked cancelled in BetterSTR.
- Guidebook links: every booking gets its own unique guest guidebook link, saved to Smoobu as the
betterstr_guideplaceholder.
Property photos don’t sync from Smoobu
Smoobu’s API doesn’t provide property photos, so your guidebooks start with a default cover image. You can upload your own property photo in the BetterSTR guide builder; it takes a few seconds per property.
Smoobu shortcodes in the guide builder
Once connected, the guide builder’s shortcode menu gains two Smoobu categories: Smoobu Fields (property-level values such as the property type, maximum guests, bedrooms, bathrooms and amenities) and Smoobu Res (per-booking values such as the confirmation ID, booking channel, adults, children, the guest’s language, the total price and deposit, and a link to Smoobu’s own guest app). Insert them like any other shortcode, e.g. {{smoobu_confirmation_id}}, and they resolve per booking when the guide is viewed.
Troubleshooting
- “Smoobu rejected the credentials”: double-check you copied both values fully from Settings → Advanced → API Keys. If you’ve lost the secret, generate a new one in Smoobu and reconnect. Remember the older Settings → Profile key won’t validate.
- Connected but no properties appeared: click Sync Properties on the Smoobu page in BetterSTR to trigger a fresh pull, and confirm the key belongs to the Smoobu account that holds your listings.
- Bookings are missing for one property: check its toggle is on in the Properties list and click Update Selected. Switching a property on syncs its bookings.
- A booking change isn’t showing yet: if you’ve set up the webhook (Step 3), changes normally land within a couple of minutes; otherwise they arrive with the hourly sync. If something is still missing after an hour, use Sync Reservations to pull it immediately.
- Rotating your credentials: use Update Credentials on the Smoobu page in BetterSTR. The new pair is checked before it replaces the old one, so a typo can’t break your existing connection.
- Disconnecting: Disconnect in the left menu removes the Smoobu connection and its synced data from BetterSTR. Also delete the BetterSTR webhook URL from Smoobu’s Settings → Advanced → API, as BetterSTR can’t remove it for you.