Facebook Tracking Pixel

Digital Guidebooks for Smoobu

Smoobu bookings arrive with guest, language and arrival details, ready for a personal guide

BetterSTR
INTEGRATION
Channel Manager & PMS

Smoobu bookings, guidebooks for every guest

Smoobu is a Berlin-based channel manager and PMS, popular with independent hosts and small agencies across Europe who want calendars, messages and a booking website in one place. Its API is strong on bookings, with guest details, arrival times, language and prices for every stay, and lighter on listing content. So the BetterSTR side works like this: bookings flow in automatically from Smoobu, and you build the look and house information of each guide once, in our guide builder, where it carries over to every future guest.

Learn About Smoobu Start Free Guidebook
Digital Guestbook Preview

What syncs from Smoobu

Smoobu calls properties apartments. Here is what BetterSTR takes from each apartment and booking:

DataSynced?Notes
ApartmentsYesName, address, map position, bedrooms, bathrooms, beds, maximum occupancy, amenities, currency and timezone.
BookingsYesArrival and departure dates, new bookings, changes and cancellations. Blocked dates aren't treated as guests.
Guest nameYesFirst and last name, or Smoobu's single guest name field when that's all there is.
Guest phone and emailYesAs stored on the Smoobu booking.
Party size, channel and priceYesAdults and children, the booking channel and the booking's price details. The guest's language is kept too.
Door or lock codesNoSmoobu's booking API doesn't include entry codes. Add access instructions in the guide.
Check-in and check-out timesPartialPer-booking times when they're set in Smoobu. Smoobu's API has no default times per apartment, so bookings without times fall back to 15:00 and 11:00. You can set your own times on each property, or for every property in Property Defaults.
Listing photosNoSmoobu's API has no photos. Guides start with a default cover until you upload your own.
Listing descriptionNoWrite your welcome text and house information in BetterSTR.

How the Smoobu connection works

1

Key and secret

In Smoobu open Settings, Advanced, API Keys. Click Create API Key, then Generate Secret. Copy both straight away, as the secret is only displayed once.

2

Connect the pair

Paste the key and secret into the Smoobu page in BetterSTR. Every request we make to Smoobu is signed with them, and the pair is checked before it is saved.

3

Paste our webhook URL

Optional but recommended. Copy your personal webhook URL from the Real-time updates card and paste it into Smoobu under Settings, Advanced, API.

With or without the webhook

Smoobu has no way for other software to subscribe to its webhooks, so the URL has to be added by you. Once it is, Smoobu notifies BetterSTR whenever a booking is created, changed, cancelled or deleted, and the guest's guide updates within moments. Skip that step and the integration still works: BetterSTR checks Smoobu for modified bookings every hour, so changes arrive within the hour instead. Apartment details are refreshed once a day.

Good to know

  • Smoobu's older single API key from Settings, Profile has been retired by Smoobu and won't connect. You need the newer key and secret pair.
  • The webhook URL contains a private token for your account, so treat it like a password.
  • Lost the secret? Generate a new one in Smoobu and use Update Credentials in BetterSTR. The new pair is tested before it replaces the old one.

Smoobu shortcodes in your guide

Smoobu Fields and Smoobu Res appear in the guide builder's shortcode menu once you connect, including:

  • {{smoobu_language}}, the guest's language from the booking, handy for a line in their own language.
  • {{smoobu_guest_app_url}}, a link to Smoobu's own guest app for that booking.
  • {{smoobu_total_price}} and {{smoobu_deposit}} for payment reminders.
  • {{smoobu_confirmation_id}}, {{smoobu_channel}}, {{smoobu_adults}} and {{smoobu_children}} per booking, and {{smoobu_amenities}} or {{smoobu_max_guests}} per apartment.

Each guide can also be shown on an Android TV in the apartment, with a WiFi QR code once you've entered your network details.

Connect Smoobu today

Key, secret, and an optional webhook for near-instant updates.

Free plan

Integration included

Moments

With the webhook added

Hourly

Backup sync without it

Start Your Free Guidebook See Pricing

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

Integration Partner

Visit Smoobu.com

More on the Smoobu connection

Smoobu questions

My old Smoobu API key won't connect. Why?

The single API key under Settings, Profile is Smoobu's older key, which Smoobu has retired. Create a new key and secret under Settings, Advanced, API Keys and use those instead.

Do I have to add the webhook URL?

No, but it's worth it. Without it BetterSTR picks up booking changes with its hourly sync. With the URL pasted into Smoobu's API settings, new bookings and changes arrive within moments.

Why do my guides have a default cover photo?

Smoobu's API doesn't provide property photos, so BetterSTR can't import them. Upload your own photo in the guide builder and it is used for every booking at that property.

Can a booking-specific check-in time show in the guide?

Yes, when the booking has a check-in or check-out time set in Smoobu. If it doesn't, BetterSTR falls back to 15:00 check-in and 11:00 check-out, because Smoobu's API has no standard times per apartment.