CUSTOMER ONBOARDING GUIDE

ForVue for Hospitable:
predict, diagnose, dispatch, repeat.

Predictive AND operational maintenance for short-term rental hosts. Forecast appliance failures before they ruin a stay, diagnose any issue in 60 seconds, pre-stock the right parts on your handyman's truck, benchmark every contractor quote, and let guests report issues directly. Your maintenance team will demand it. Your CFO will justify it. This guide walks you from one-click Hospitable connection through your first owner statement.

Version 1.1 · Last updated July 9, 2026 · ~8 minute read · Questions?
CONTENTS
  1. Before you connect — what you need
  2. Trial, billing, and account structure
  3. Connecting Hospitable — one click
  4. What syncs, and how often
  5. What ForVue does with your data
  6. Scopes & data flow — what we touch, what we never touch
  7. Owner statements & reports
  8. Security & compliance
  9. Monthly cadence — how mature hosts use ForVue
  10. Troubleshooting
  11. Support & contact

SECTION 1Before you connect — what you need

Unlike most integrations, there is no API key to request, no token to generate, and no IT ticket to file. You need exactly two things:

1.1 A Hospitable account you can log into

You connect by signing into Hospitable through their standard authorization screen and approving ForVue. If you can log in to Hospitable and you manage the properties you want to bring into ForVue, you have everything you need.

1.2 Authority to approve an app on the account

Whoever clicks "Connect with Hospitable" must be able to authorize a connected application on that Hospitable account. For most hosts that's just you. For larger teams, it's whoever administers the Hospitable account.

You never share a password or API key with ForVue. Connection happens through Hospitable's official OAuth flow. You sign in on Hospitable's own screen — ForVue never sees your Hospitable password. Hospitable hands ForVue a revocable access token scoped to the read permissions you approve.

SECTION 2Trial, billing, and account structure

2.1 The 7-day free trial

Every new ForVue account starts with a 7-day free trial. You enter a card at signup (Stripe) so the trial converts seamlessly — but you are not charged until day 8. Cancel any time during the trial from Stripe and you owe nothing.

2.2 Pricing after the trial

2.3 Account structure

One ForVue account per portfolio. Inside that account, every daily user gets their own login (no shared passwords). The account owner can invite users in Settings → Team, and each team member can be scoped to a subset of properties instead of the full portfolio — useful for regional co-hosts, cleaner networks with different service zones, or a maintenance vendor who only needs visibility into the properties they cover.

2.4 Referral program

Every ForVue account gets a referral code (in Settings → Referrals). Every qualified referral unlocks a coupon tier: 20% off for 60 days (1 referral), 50% off for 60 days (2 referrals), 50% off for 12 months (3 referrals). Rewards apply automatically once a referred account crosses its 30-day mark on a paid subscription. No clawback if a referred user later churns.


SECTION 3Connecting Hospitable — one click

There are two ways in, depending on whether you already have a ForVue account.

3.1 New to ForVue (from the Hospitable Apps Marketplace or the marketing page)

1
Click "Connect with Hospitable"

From the ForVue listing in the Hospitable Apps Marketplace, or from platform.investwisecap.com/hospitable, click Connect with Hospitable.

2
Sign in to Hospitable and approve ForVue

You'll land on Hospitable's own authorization screen. Sign in and review the read permissions ForVue is requesting (listed in Section 6). Click Authorize.

3
Set your password and confirm pricing

ForVue reads your email and property count from Hospitable to pre-fill a short welcome screen. Set a password, confirm the $2.50/unit/month pricing and 7-day trial, and save your card via Stripe. No charge until day 8.

4
Watch the first sync

ForVue immediately begins importing your portfolio. You'll see a sync screen; most accounts are ready in 30–60 seconds, after which your dashboard loads automatically.

3.2 Already have a ForVue account

1
Settings → Integrations → Hospitable → Connect

The gear icon (⚙️) is in the top-right of the ForVue chrome. Settings → Integrations lists every platform ForVue can connect to. Click Hospitable, then Connect, and approve ForVue on Hospitable's authorization screen. Your sync starts immediately.

What you should see when it works Your properties list populates · Recent reservations and reviews appear · The Hospitable integration card shows a green "connected" state with a "Last sync" timestamp.

SECTION 4What syncs, and how often

ForVue connects through Hospitable's official Vendor API and keeps your data current two ways:

On the first connection, ForVue pulls your full history: properties, units, reservations (past, current, and upcoming), reviews, guest messages, Hospitable issue flags, and calendar notes.


SECTION 5What ForVue does with your data

ForVue is a predictive AND operational maintenance layer — it reads your guest communications and reservation history to surface issues early, and then makes the actual fix faster and cheaper. Six pillars ship today; each one applies to STR portfolios.

5.1 Predict — failure forecasting per appliance

For each appliance ForVue tracks (HVAC, water heater, refrigerator, washer, mini-split, and more), it runs a proprietary multi-factor Weibull-Bayesian survival model to estimate when that unit is most likely to fail — factoring in age, usage intensity derived from your occupancy data, service-event history, and maintenance signals from guest messages. The dashboard surfaces these as risk bands (0.00–0.99) so you can replace proactively rather than mid-guest-stay. The specific factors, weights, and cascade rules are trade secrets of Wise Capital, LLC (DTSA-protected; USPTO 64/032,704).

5.2 Diagnose — 60-second issue triage

On every appliance page, pick a symptom, enter an error code from the unit's display, or upload a photo / audio recording of the noise. Get the most likely failed component, ranked against the unit's actual risk score, with OEM part number, supplier links, repair difficulty, warranty status, manufacturer service bulletins, $0 fixes to try first, and a brand-specific repair video. Photo recognition and audio description use AI; the underlying scoring and symptom-to-component routing are deterministic against our manufacturer knowledge base. Your handyman or local turnover crew diagnoses in 60 seconds instead of 30 minutes.

5.3 Stock — pre-load the truck

Across your portfolio, ForVue identifies the components most likely to fail in the next 90 days and tells your maintenance handler what parts to keep on the truck. For STRs this is huge — the difference between fixing a "no cold air" issue same-day (because the capacitor was on the truck) and refunding two nights because parts had to ship.

5.4 Quote-check — flag overpriced contractor estimates

Every external quote you enter is benchmarked against the median cost we've seen for that part on similar appliances across your portfolio's service history. A $400 condenser fan motor quoted at $1,200 gets flagged before you approve it. Real money for an STR operator who gets a service quote on every turnover problem.

5.5 Vendor — vetted local contractors on demand

Need an HVAC contractor in your guest property's zip right now? 4★+ filtered results from Google Places, with each vendor's state license verified against the appropriate licensing board. Add your own private vendor list, too. No more "who can come Tuesday?" panic on a Friday-arrival, $400-a-night booking.

5.6 Tenant / guest direct reporting (incl. Hospitable signal detection)

Three paths land here:

What ForVue does not do ForVue does not reply to your guests, does not pick or dispatch vendors automatically, and does not send any message on your behalf. It detects the signal, logs it, scores it, and gives you the diagnose / stock / quote-check / vendor tools to act on it — but the actual decision is always yours. ForVue never has write access to your Hospitable account.

SECTION 6Scopes & data flow — what we touch, what we never touch

6.1 The read permissions ForVue requests

All read-only. You approve these on Hospitable's authorization screen.

ScopeWhat it lets ForVue read
property:readYour properties and their details
listing:readYour listings across connected channels
reservation:readReservations — past, current, and upcoming — and their statuses
reservation:financialsReservation revenue, used for owner-statement allocation and revenue-impact ranking
message:readGuest message content, scanned for maintenance signals
reviews:readPublic ratings and private feedback, scanned for maintenance signals
calendar:readCalendar and occupancy, used to derive appliance usage intensity

6.2 What ForVue NEVER touches

6.3 Data flow diagram

Hospitable API ─── HTTPS / TLS 1.3 ───► ForVue server (public.api.hospitable.com) (United States · DigitalOcean · encrypted at rest) ▲ │ OAuth access token (read-only, revocable) │ ┕── webhooks (real-time) + 6-hour full reconciliation ForVue server ─── HTTPS / TLS 1.3 ───► Your browser (Authorization: Bearer <wc_token>)

6.4 Disconnecting

You can revoke ForVue's access at any time from your Hospitable account → Apps page. Revocation is immediate — ForVue stops pulling within seconds. You can also disconnect from the ForVue side in Settings → Integrations → Hospitable.


SECTION 7Owner statements & reports

Once service events are flowing, ForVue can roll them up into reports.

7.1 Monthly Owner Statement

In Reports, the Owner Statement generator lets you pick a month and produce a printable statement of that month's maintenance costs, grouped by property and unit, with per-unit subtotals and full line-item detail (date, event type, appliance, technician, invoice number, costs). Open it and use your browser's Print → Save as PDF to share it with an owner or bookkeeper.

7.2 Portfolio Action Report

New. One page per property, grouped by property, listing every CRITICAL and WARNING component with recommended next-service dates and projected failure windows. Rendered in-browser and printed / saved-as-PDF using your browser's print dialog. Use this for weekly maintenance stand-ups, monthly ownership updates, and quarterly board packets.

7.3 Single-Appliance Action Report

New. Full lifecycle sheet for one appliance: component list, service history, projected next failures, recommended actions. Triggered from any appliance detail card. Also rendered in-browser (print / save-as-PDF from the browser dialog). Use this to hand a maintenance vendor a self-contained work order for one asset, or to attach an appliance-specific history to an insurance claim.

7.4 Portfolio reports

The Reports section also includes Portfolio Risk, Maintenance Cost History, Cost Savings, and Projected Failures — each with a CSV export for your own analysis.


SECTION 8Security & compliance


SECTION 9Monthly cadence — how mature hosts use ForVue

Weekly (5 minutes)

Monthly (15–20 minutes)

Quarterly


SECTION 10Troubleshooting

The connection screen sent me to a Hospitable error

  1. Confirm you're logged into the correct Hospitable account before clicking Connect.
  2. Make sure you have authority to approve a connected app on that account.
  3. If you see an "invalid client" or redirect error, the listing may still be in review on Hospitable's side — contact wise@investwisecap.com and we'll confirm status.

My properties haven't appeared yet

  1. Large portfolios can take longer than 60 seconds on the first sync. Properties appear as they finish importing.
  2. Wait for the full reconciliation (runs every 6 hours) or trigger a manual sync from Settings → Integrations → Hospitable.
  3. If nothing appears after a few minutes, email wise@investwisecap.com with your account email.

I want to stop ForVue from accessing my account

Revoke access from your Hospitable account → Apps page, or disconnect in ForVue under Settings → Integrations → Hospitable. Either stops data pulls immediately.

Billing question

Settings → Account → Manage Billing opens the Stripe customer portal. Update your card, download invoices, or change your billing email there.


SECTION 11Support & contact