BookThemTwiceGet a demo →

Guest Sync setup kit

Your past guests, in your account, every night.

This kit connects Hospitable (and PriceLabs, if you use it) to your Book Them Twice account. The sync runs in your own Viktor, so your logins never leave your hands. Do it before your kickoff call: your Viktor walks you through each step. Plan on 1 to 2 hours the first time, and take your time. The setup guide shows a picture of every click.

  1. Before the call

    • Your own domain is bought (step 3 on your start-here page). Have the login for the company you bought it from.
    • You can log in to app.bookthemtwice.com.
    • You can log in to Hospitable as the account owner or a full-access admin.
    • If you use PriceLabs: you can log in to PriceLabs, your plan is paid, and Airbnb is connected in PriceLabs.
    • Slack is open on your computer, with a direct message to Viktor ready.
    • No Viktor or Slack yet? Get Viktor at go.cashflowdiary.com/viktor ($100 off and $100 in free credits) and Slack at go.cashflowdiary.com/slack.
    • You're at a computer, not a phone.

  2. Make your Book Them Twice key 5 to 10 minutes

    1. Log in at app.bookthemtwice.com.
    2. Click Settings (bottom left), then Private Integrations.
    3. Click Create new Integration. Name it BTT Sync.
    4. Tick these 9 permissions. The last four also let Guest Vanessa send messages later, so you only visit this screen once:
      • View Contacts
      • Edit Contacts
      • View Custom Fields
      • Edit Custom Fields
      • View Locations
      • View Conversations
      • Edit Conversations
      • View Conversation Messages
      • Edit Conversation Messages
    5. Click Create, then use the copy button next to the key. Don't select it with your mouse. It's shown only once, so keep the tab open until step 4.

    Don't see Private Integrations? Tell us on the call and we switch it on for your account.

  3. Make your Hospitable key 5 to 10 minutes

    1. Log in at my.hospitable.com.
    2. In the left sidebar, click Apps (on some accounts: Settings > Integrations), then API access.
    3. On the Access tokens tab, click + Add new. Name it BTT Sync.
    4. Tick Read only. Leave Write unticked. Read can't change your prices, calendar or listings.
    5. Click Create and copy the token with the copy button. It's shown only once.

    PriceLabs (optional): Account Settings > API Details > Enable > I Need API Access, type API, Continue, then Copy API Key. PriceLabs charges $1 per listing per month for this, billed by PriceLabs.

  4. Paste this into Viktor 5 minutes

    Click Copy the prompt. In Slack, type @Viktor, pick Viktor from the list, paste and press Enter. Viktor sends you a secure form for each key. Paste each key into its form, never into the chat.

    Install the Book Them Twice Guest Sync for me.

1. Download https://www.bookthemtwice.com/sync-kit/btt_sync.zip and unzip it so the files sit in skills/btt_sync/. Read skills/btt_sync/SKILL.md first.
2. Create these custom API integrations and send me the secure form for each. Never ask me to paste a key in chat.
   - "BTT Hospitable": base URL https://public.api.hospitable.com/v2, bearer token, GET only.
   - "BTT GHL": base URL https://services.leadconnectorhq.com, bearer token, GET and POST. This one key also has the 4 Conversation permissions Guest Vanessa needs later.
   Before saving any key, remove spaces and line breaks from both ends. If a key is rejected for a character that isn't allowed, ask me to copy it again from the source with its copy button.
   - "BTT PriceLabs" (only if I tell you I use PriceLabs): base URL https://api.pricelabs.co/v1, header X-API-Key, GET only.
3. Copy config.example.json to config.json. Fill in the slugs of the integrations you made and my Book Them Twice location ID: PASTE-LOCATION-ID
4. Run check. Then run setup-fields as a dry run. If fields are missing, tell me how many and create them after I say yes.
5. Run the sync as a dry run and tell me in plain words: how many properties, stays and guests, and how many would be added.
6. When I say go: ask me to set the BTT GHL POST tool to run automatically, run the sync with --apply, show me the result, then schedule it every night at 3:00 AM my time. Only message me if something fails.

    Your location ID is the code after /location/ in your browser's address bar when you're logged in to app.bookthemtwice.com. Got a personal link from us? It fills this in for you.

    No 👀 on your message within a minute? It probably doesn't start with @Viktor. Edit the message, add @Viktor at the start, pick Viktor from the list, and save.

  5. Check it, then switch it on 10 to 20 minutes

    • Viktor shows the dry run first. Nothing is written until you say go.
    • Open two or three guests in your account and check their stays and totals look right. The day before your call, we check from our side too.
    • Then run the ready check on your start-here page and book your call.
    • From then on it runs every night at 3:00 AM and only messages you if something fails.

  6. What it does, and what it never does

    • Does: brings each guest in with their stays, nights, total spend, last checkout, next arrival, party size and a segment (VIP, repeat, one-time, upcoming).
    • Never: changes your Hospitable calendar, prices or listings, or your PriceLabs settings.
    • Never: marks a guest as opted in to marketing. Airbnb and Vrbo guests haven't opted in. Stay messages go to booked guests, and marketing goes only to guests who opt in on your own site.
    • To turn it off: delete the "BTT Sync" token in Hospitable (Apps > API access) and the "BTT Sync" key in Book Them Twice (Settings > Private Integrations). Access stops right away.

    Files: btt_sync.zip (the skill, the script and the field list Viktor installs). Help: reply to your welcome email or write to support@bookthemtwice.com.