Connecting

How Convivial connects to Hospitable

Two minutes, no passwords shared with us.

From the app

  1. Open Convivial and tap Connect Hospitable.
  2. Sign in on Hospitable's own page. Convivial never sees your password.
  3. Review what Convivial asks for and tap Authorize.
  4. You're back in the app, and the first sync starts.

From Hospitable's Apps page

Choose Convivial in Hospitable's app marketplace and tap Get started. If you're on a computer, Convivial shows a QR code and a short code. Scan the QR code with your iPhone camera, or enter the code in the app under I have a code. The code works once and expires after 10 minutes.

What Convivial can read

  • Properties and listings: names, photos, addresses and house details
  • Reservations, including the payout breakdown per night
  • Calendar availability and nightly prices
  • Reviews
  • Guest conversations, plus sending a message when you tap Send

Convivial never changes calendars, prices, availability or listings.

Who can connect

The account owner, or a teammate with full access, on a Hospitable plan that includes integrations. The Essentials plan does not support connected apps.

Notifications

Once connected, Hospitable tells Convivial when something changes, and Convivial sends a push notification to your iPhone: guest messages, new bookings and requests, cancellations, date and guest-count changes, guest issues and new reviews. Choose which ones you want in Settings, then Notifications. You can hide message text from notifications there too.

Disconnecting

In Convivial: Settings, then Disconnect and delete data. In Hospitable: Apps, then Connected integrations, then remove Convivial. Either way, our service deletes your login, device tokens and property list straight away.

Using an access token instead

If you'd rather not use Connect Hospitable, create a personal access token in Hospitable under Apps, then API access, and paste it in Convivial under Use an access token instead. The token stays on your iPhone. Token connections don't get push notifications, because those need Hospitable to reach our service.