Loading...
This reference lists what Haven currently reads from Lodgify, what Haven writes to Lodgify, which Lodgify webhooks Haven uses, and the important limits of each path.
For connection instructions, see Connect Lodgify to Haven.
Haven reads:
Haven writes:
Booked)Tentative) and inquiries (enquiries)A Lodgify account is identified by its numeric user id (Lodgify has no "who am I" endpoint, so Haven reads it from the availability feed during connect). Each Haven listing maps to one Lodgify room type inside a Lodgify property — the sync key is propertyId:roomTypeId. A Lodgify property with several room types imports as several Haven listings that share address and house-level settings.
Room types with more than one unit currently import with calendar pushes restricted (Haven never writes blocks for a pooled room type); full multi-unit room support is rolling out separately.
is_active)Street address, zip, city, state, country, and coordinates import into the Haven location fields. Lodgify's "hide address" preference is recorded but Haven's own address-privacy setting governs what guests see.
Lodgify amenity entries are matched against Haven's amenity vocabulary in two passes: a direct name match first, then a text match through the shared amenity mapper. Amenities Haven can't recognize are recorded for review rather than dropped silently. Room-count entries (bedrooms/bathrooms) are handled as counts, not amenities.
Lodgify exposes these only inside a booking quote, so Haven runs one deterministic quote probe per listing during import and refresh: a quote for the first bookable date at the minimum stay. The quote's cancellation policy text becomes the Haven cancellation policy, and the security deposit becomes Haven's security deposit. If the probe can't run (for example, no bookable date in the window), those fields are simply left unset — never guessed.
From Lodgify rate settings, fixed per-stay fees map onto Haven's named fee slots:
Other fees import as Haven custom fees when their basis maps exactly (fixed per stay, per night, per person, per person per night, or a percentage of the fare). Fees that only apply above a minimum number of nights, or with a basis Haven can't charge identically, are not imported — they're surfaced as sync notices so you can decide how to handle them, because importing them approximately would change what guests pay.
Haven's management fee and community fee can each be set to a flat amount or a percentage of the nightly rate, but a sync always writes a flat amount and resets the field to $. Unlock the fee field if you want to keep Haven's percentage. Your service fee ("keep the margin") is Haven-only and is never touched by a sync — see Your Service Fee (Keep the Margin).
Taxes configured in Lodgify rate settings mirror into Haven tax rules:
Per-person fixed taxes are reported but not imported (Haven has no per-person tax calculation). Mirrored rules are owned by the sync: they can't be edited or deleted in Haven's tax editor, and the editor's Sync from Lodgify button re-mirrors them on demand. Your own Haven-authored tax rules coexist untouched.
Lodgify promotions that exactly match a Haven discount type (early-bird, last-minute, trip-length, weekly, monthly) import into those fields. Anything else is reported as unmapped rather than approximated.
Lodgify add-ons with a fixed price import as Haven upsells (percentage add-ons are reported, not imported).
From the Lodgify rates calendar:
From rate settings and availability:
Per-night maximum-stay values and multiple rate tiers per day are not modeled in Haven; when Lodgify sends several rate tiers for one day, Haven uses the tier with the lowest minimum stay.
Booked → confirmed reservation (holds dates)Tentative → pending reservation (holds dates; the tentative expiry is recorded)Open (an unconverted enquiry) → pending, holds no dates — matching Lodgify, which keeps those dates bookableDeclined, cancelled, or deleted → cancelled (dates released)Unavailable → an owner block, not a guest reservationEach booking imports with dates, guest breakdown (adults/children/infants/pets), guest name/email/phone, source channel (Airbnb, Booking.com, Vrbo, Expedia, direct, iCal, email), booking timestamps, and financials (total, paid, due, and the quote's line items). Guests are added to your Haven guest CRM. Booking notes in Lodgify are not copied into Haven.
Lodgify closed periods mirror as blocked dates in Haven, labeled "Blocked via Lodgify." Preparation-time buffer days stay unavailable but are never treated as host blocks. Channel iCal blocks from Lodgify's calendar connections mirror as external blocks.
When a guest books on your Haven site:
Booked reservation is created in Lodgify immediatelyTentative reservation holds the dates while you decide; approving converts it to Booked, declining frees the datesEach pushed booking carries the stay total Haven charged (Lodgify displays it; Haven's Stripe charge remains the financial source of truth), the guest breakdown, and a booking note ("Booked on Haven") with the reservation details.
Pushed bookings carry a Haven alias email for the guest instead of their real address. Lodgify's automatic guest emails for the booking route back into Haven's inbox rather than double-messaging the guest, and replies you send from Lodgify reach the guest through Haven. The guest's real contact details stay in Haven.
The mirror of a pushed booking coming back over webhooks/polling is recognized as Haven's own and never double-blocks dates or re-notifies you. Blocks Haven wrote to Lodgify are tagged so the return echo is attributed to Haven, not to Lodgify.
When Manage pricing in Haven is enabled for a listing, Haven pushes nightly rates and stay rules to Lodgify (in contiguous ranges, up to the standard 730-day horizon). Independent of pricing:
Room types with multiple units never receive availability writes (rates still push — they're type-level).
Before accepting payment, Haven re-checks the exact stay dates against Lodgify's live availability feed so a booking made moments earlier in Lodgify (or an OTA) can't be double-sold. Lodgify's API also enforces minimum-stay rules on booking creation, which Haven surfaces as a normal availability error.
You pick which Lodgify room types to import (or turn on auto-import for new ones). Each import brings content, photos, fees, taxes, rates, availability, and reservations, and runs the quote probe.
A property poll refreshes content, fees, taxes, and settings roughly hourly, and detects room types deleted in Lodgify (their Haven listings are unlisted and flagged, never silently deleted).
Calendar and reservations poll every few minutes as a webhook safety net, over the standard 730-day forward window. The reservation poll also sweeps Lodgify's reservation feed for closed periods webhooks may have missed.
Webhooks (below) deliver most changes within seconds; polling reconciles anything missed. A 15-minute health check re-subscribes any webhook Lodgify has dropped.
Haven subscribes each connection to all ten Lodgify webhook events:
rate_change — refreshes the affected calendaravailability_change — refreshes the affected date range for every mapped room type of the propertybooking_new_any_status, booking_new_status_booked — new bookingsbooking_change — booking modificationsbooking_status_change_booked, booking_status_change_tentative, booking_status_change_open, booking_status_change_declined — status transitions (a declined tentative releases its dates)guest_message_received — new guest messagesEach subscription gets its own Haven endpoint URL with a random routing token, and its own signing secret issued by Lodgify. Every delivery must carry a valid HMAC-SHA256 signature (ms-signature header) or it is rejected. Duplicate deliveries are acknowledged without reprocessing. Transient failures on Haven's side return an error status so Lodgify redelivers (Lodgify retries up to 10 times); permanently unparseable payloads are acknowledged and surfaced to Haven engineering instead of being retried forever.
Disconnecting removes Haven's webhook subscriptions from your Lodgify account and deletes the stored API key.
Fields that Lodgify owns (title, description, photos, fees, and so on) show a sync lock in the Haven listing editor — edit them in Lodgify and the change flows in. Calendar fields are two-way. Pricing direction flips when you enable Manage pricing in Haven: until then Lodgify's rates flow in; after, Haven's push out. Tax rules mirrored from Lodgify are locked in the tax editor with an on-demand Sync from Lodgify refresh.
Fields Haven never reads from Lodgify (for example, Haven-specific settings like your site design, markups, or guest-offer configuration) are always yours to edit.
New to Haven?
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
© 2026 Book With Haven, LLC.