Smoobu Integration
Haven connects to Smoobu natively with a Smoobu API key and its secret. Your listings' structure, rates, availability, reservations, and guest messages stay in sync while Smoobu remains your operations hub.
Connect
Smoobu switched off key-only access (the old key under Settings → Profile → API Key) on 31 October 2026.
- In Smoobu, open Settings → Advanced → API Keys
(direct link), choose
Create API Key, then Generate Secret. Copy both the key and the
secret. The key starts with
usr_live_. Smoobu shows the secret only once. The old key under Settings → Profile → API Key is rejected. - In Haven, go to Integrations → Connect Smoobu. One window walks you
through four steps:
- Connect: paste the key and the secret.
- Match: if you already have listings in Haven, pair each Smoobu apartment with the listing it already is, or import it as new.
- Plan: on a paid plan, confirm what any new listings add to your bill before they import. Skipped when nothing changes.
- Photos: bring your photos in from Airbnb (see below).
- Haven imports every apartment in the account and keeps importing new ones. You can switch auto-import off on the Smoobu card and pick listings yourself.
Two things can block the connection:
- Free trial accounts need Smoobu support to switch API access on.
- An IP allow list on the key blocks Haven. Leave it empty.
What syncs from Smoobu
| Data | Notes |
|---|---|
| Listing name, address, map location, time zone | Locked in Haven while synced; an apartment with no address in Smoobu stays editable in Haven |
| Bedrooms, bathrooms, beds, maximum guests, amenities, property type | Locked in Haven while synced. Each room count Smoobu sends locks on its own, so with no amenities ticked in Smoobu your amenity list stays editable (and fills from Airbnb) while bedrooms, bathrooms and beds follow Smoobu; click a count's Synced from Smoobu badge in Add amenities to edit just that count in Haven. Smoobu's blank defaults (1 guest, 0 rooms, no amenities) are not synced: until you fill them in Smoobu, these stay editable in Haven |
| Nightly prices and minimum stays | Each night you priced in Smoobu's rate calendar. Once Smoobu has sent prices, the base and weekend rate on Calendar → Price are locked as synced from Smoobu and read Not set (the price lives on each night of the calendar); turn on Manage pricing in Haven to set your own. Smoobu has no base price and doesn't share prices you set only on Airbnb, so a listing Smoobu sends no prices for needs a Base nightly rate in Haven before it can take bookings |
| Blocked nights | Shown as "Blocked via Smoobu" |
| Reservations from every channel | Airbnb, Booking.com, Vrbo, direct and others |
| Booking totals and price lines | Shown on the reservation in Haven |
| Guest messages | Guest messages and your replies written in Smoobu |
| Door codes | From Smoobu's lock integrations (Nuki, igloohome and others) |
| Guest list | From your Smoobu guests |
| Mandatory add-ons | Become the listing's custom fees (Calendar → Price tab), locked as synced from Smoobu |
| Optional add-ons | Become upsells on the Smoobu tab under Upsells, with Smoobu's name and price |
Add-ons and fees
Haven reads each apartment's add-ons from Smoobu on every sync:
- Mandatory add-ons (not optional in Smoobu) become the listing's custom fees, charged per booking, per person, per night or per person per night, exactly as Smoobu calculates them. They are locked as synced from Smoobu: change them in Smoobu, and Haven updates them on the next sync.
- Optional add-ons become upsells on the Smoobu tab under Upsells. Smoobu owns the name, price and taxable flag. When an upsell first arrives, it takes Smoobu's max quantity (above 1, guests get a quantity picker capped there) and starts off for Guest Offers if Smoobu shows it in the booking tool only. After that, quantity and placement are yours to change in Haven. A sync never puts an upsell on your property page or in checkout; you turn those on.
- Percentage add-ons are not charged. Smoobu does not say what the percentage is of, so Haven lists them as not charged in the listing's sync notices (under Custom fees on the Price tab) instead of guessing. The same goes for an add-on with no amount or a calculation type Haven does not know. Add an equivalent fee or upsell in Haven if you want to charge it.
- Smoobu's tax percent is not copied. An add-on with any tax in Smoobu is marked taxable, and your listing's own tax settings decide the amount.
Editing an add-on in Smoobu updates it in Haven on the next sync; deleting it removes the fee or switches the upsell off. On a booking, Haven still sends Smoobu its fees and add-ons as summed price lines, not one line per add-on.
What Smoobu does not send
Smoobu's API has no photos, descriptions, house rules, check-in times, taxes, cancellation policy or reviews. They stay yours to edit in Haven and Smoobu never overwrites them.
The last step of connecting (Copy your photos from Airbnb) fills them in, whether you connect from Integrations or from onboarding's Connect your PMS step (onboarding asks right after your listings import). Haven only reads your Airbnb listing — it never lists, unlists or changes anything on Airbnb or Vrbo.
- Copy photos from my Airbnb listing connects your Airbnb account as a content source only. Haven pairs each Airbnb listing with its Smoobu apartment (by address, map pin or name, and asks you about any it cannot pair), then copies the photos, descriptions and amenities into whatever is still blank. Close that question to answer it on your next visit to Integrations. Continue or Don't show again stops it asking about those apartments. Nothing else changes: Smoobu keeps running your calendar and bookings, and Haven never writes to Airbnb. This works for listings you own — co-hosted listings do not appear.
- I don't use Airbnb (or Skip for now) moves to the next step, which asks for a link for each imported listing that still has no photos — Airbnb, Vrbo or your own website — and pulls its photos and copy into the blank fields. Use it for co-hosted listings or if you are not on Airbnb.
- Upload photos, beside both, opens the listing's gallery in Haven so you can add the photos you already have.
Until every listing has photos, the whole Smoobu card turns amber (Connected · photos missing) and its Listing photos row counts the listings without any, says why in a sentence, and offers both ways to fill them side by side: Copy photos from my Airbnb listing, Paste listing links and Upload photos. The first two open the same step on the path you chose; the third opens the first waiting listing's gallery. If your listings are still without photos a day after they imported, Haven emails you once with the same options; its buttons open Integrations straight on that step. While Haven copies photos from Airbnb or from a pasted link, the row shows Pulling photos for your listings with a progress bar and updates by itself when they land. Once Airbnb is linked the card turns green and the row shows Syncing from Airbnb, with Resync and Unlink Airbnb.
A Smoobu listing with no photos also says so above its gallery (Edit Listing → Photos): Smoobu doesn't send photos or descriptions, with Paste a listing link and Copy photos from my Airbnb listing, which open the same step on Integrations.
What Haven sends to Smoobu
-
Direct bookings. A booking made on your Haven site appears in Smoobu as a paid booking with the guest's name, your listing's check-in and check-out times, the price lines, and the guest's real email and phone in the booking notes. Its nights close on every channel Smoobu manages. Cancelling it in Haven cancels it in Smoobu.
-
Blocked dates you set on your Haven calendar, shown in Smoobu as a blocked booking under the guest name "Haven Block" (Smoobu needs a guest on every booking). Unblocking in Haven removes it.
-
Booking requests. When "Hold dates for pending requests" is on, a request shows in Smoobu as a block with the guest's name, dates, guest count and quoted total in its notes. Approving the request in Haven turns the block into the booking; declining it, or letting it expire, removes the block. With that setting off, nothing appears in Smoobu while the request is pending; the booking is created there when you approve it.
-
Guest count changes you make to a Haven booking.
-
Prices and minimum stays you change on the Haven calendar.
-
Blocks you add on the Haven calendar. Haven creates them in Smoobu as bookings on the Blocked channel under the guest name "Haven Block", marked
[Haven block]in the notes, and removes only those. -
Check-in and check-out times when a guest buys an early check-in or late checkout.
-
Messages. Replies from the Haven inbox, AI replies, booking automations, and guest portal links go through Smoobu, which delivers them on the booking's own channel: Airbnb and Booking.com messaging, or email for direct bookings. Airbnb and Booking.com show messages as plain text, and Booking.com may remove links.
-
Haven links for your Smoobu templates. Turn on Add Haven links to Smoobu templates on the Smoobu card in Settings → Integrations, and Haven keeps two Smoobu custom placeholders filled in for you:
[havenGuidebookUrl], each listing's Haven guest portal link, and[havenPortalLink], each stay's own Guest Portal link, which signs the guest straight into their stay. Paste either into your own Smoobu message templates. Listing links are written when you turn it on and kept current on every sync; a booking's link is written when that booking syncs. The same switch keeps three more placeholders on each booking:[havenVerificationStatus](the Haven ID check:verified,pending,failed,waivedornot_required),[havenAgreementStatus](the Haven rental agreement:signed,pendingornot_required) and[havenAgreementUrl](a link to the PDF the guest signed), updated the moment the guest signs, the ID check comes back, or you skip a step. Haven never edits your templates, and turning it off stops new writes.
Limits to know about
- Changing dates. Smoobu cannot change the dates of an existing booking. When you move a Haven booking's dates, Haven tells you to update the booking in Smoobu.
- Required booking fields. If your Smoobu booking form (Booking tool → Form Content) requires a guest address or other details Haven does not collect, Smoobu refuses the booking and Haven tells you which fields to make optional.
- Your own Smoobu emails. Bookings Haven sends to Smoobu carry a Haven relay address for the guest, so Smoobu's automated emails do not reach them. Haven's booking messages are what the guest receives.
- Message times. Smoobu does not report when a message was sent, so older messages Haven catches up on show the time they were imported.
Disconnect
On the Smoobu card choose Disconnect. Imported listings stay in Haven. The API key and its secret stay valid in Smoobu until you delete it there.
Related Articles
New to Haven?
Everything in this guide, done for you
Haven is the direct booking platform these guides are written for — a branded site, secure payments, and guest relationships you own. Build yours free.
Free to build · No credit card · Private until you publish