WithinstaySetup
OverviewGuestsAdd-onsEmail engineConnectionsSettings

Connection workspace

Track provider access, credentials, data maps and sync readiness from one operator console.

Host console

Backend dashboard for operators and integration setup.

Create account

Connections

Build the universal connection layer around Withinstay-owned guest data, hosted arrival forms, Resend guest emails, optional Google Sheets backups, WhatsApp alerts and channel message templates.

Start walkthrough

Sync health

Drafted

System record

Withinstay

Backup outputs

1

Email flows

3

D

Withinstay dashboard data

data

System of record

Withinstay is the canonical database. External services deliver guests into the flow, send messages or receive optional backups; they do not become the operating database.

Guest dashboardInternal guest recordsOrder managementFulfilment tracking
Docs
F

Hosted pre-arrival forms

forms

Native core

This becomes the universal layer: every host gets a branded arrival form link that can be sent through any platform message, email, WhatsApp or PMS template.

Branded pre-arrival formsDynamic host fieldsShareable linksAdd-on requests
Docs
R

Resend

email

Email backbone

Resend becomes the hosted transactional email layer for Withinstay, with optional hosted template IDs and webhooks for sent, delivered, bounced, complained and suppressed events.

Guest confirmationsHosted order emailsHost notification emailsHosted templates
Docs
A

Airtable

data

Not primary

Airtable is no longer part of the default product path. Guest data should stay in Withinstay; if Airtable is used later, it should be a controlled manual export or internal prototyping tool.

Internal prototypingManual exportsService catalog experimentsPartner roster research
Docs
S

Google Sheets

backup

Optional backup

Sheets is an optional one-way backup/export for hosts who want their own copy. Withinstay remains the dashboard and system of record.

One-way backupAppend rowsManual export runsScheduled export later
Docs
G

Gmail

messaging

OAuth app needed

Gmail is no longer the core sending layer because Resend owns transactional guest email. Gmail can still become a host mailbox connector for drafts, labels or reply capture after OAuth review.

Send emailsDraft emailsLabelsThread lookup
Docs
W

WhatsApp

messaging

Business setup

WhatsApp is a strong universal guest channel once a host has a Meta app, phone number ID and approved templates.

Template messagesText messagesMedia messagesDelivery status webhooks
Docs
A

Airbnb message templates

channel

Template delivery

This avoids restricted Airbnb APIs: the host uses Airbnb’s own automated guest messaging to deliver a Withinstay form link.

Quick repliesScheduled quick repliesReservation placeholdersPre-arrival timing
Docs
B

Booking.com message templates

channel

Template delivery

This avoids needing full Connectivity API access on day one while still reaching Booking.com guests through supported messaging surfaces.

Guest messagingAuto-repliesTranslated templatesManual fallback
Docs
H

Hostaway

pms

Credential-ready

Hostaway can still enrich Withinstay with listing/reservation/calendar data, but the arrival form link works without it.

ListingsReservationsListing calendarsCalendar blocks
Docs

Selected

Resend

Email backbone

Own the guest email lifecycle after a guest enters a Withinstay flow: confirmations, add-on order emails, host alerts and delivery tracking.

Credential fields

RESEND_API_KEYRequired
Verified sending domainRequired
From emailRequired
Webhook signing secretRequired

Data controls

Withinstay records
Guest arrivals
Add-on orders
Resend guest emails
Google Sheets backup
PMS enrichment

Connection setup flow

1

Create a Resend account or add Resend from the Vercel Marketplace.

Owner-visible setup step for the onboarding walkthrough and internal implementation checklist.

2

Verify the Withinstay sending domain or a dedicated sending subdomain.

Owner-visible setup step for the onboarding walkthrough and internal implementation checklist.

3

Add RESEND_API_KEY, RESEND_FROM_EMAIL and optional hosted template IDs to Vercel.

Owner-visible setup step for the onboarding walkthrough and internal implementation checklist.

4

Create a Resend webhook pointing at /api/webhooks/resend.

Owner-visible setup step for the onboarding walkthrough and internal implementation checklist.

5

Submit a test arrival form and confirm guest_email_events records the send lifecycle.

Owner-visible setup step for the onboarding walkthrough and internal implementation checklist.

Data mapping

Guest form answers map into Withinstay first. External services handle delivery, enrichment or backup exports only.

ProviderSource objectWithinstay map
WithinstayCanonical guest dataguest_form_submissions
WithinstayAdd-on/order managementfulfilment_requests
ResendGuest lifecycle emailguest_email_events
Google SheetsOptional backup copydata_export_runs
GmailMailbox handoff onlymessages
WhatsAppGuest alert/reply channelguest_messages
AirbnbScheduled quick replychannel_message_templates
Booking.comGuest message templatechannel_message_templates

Withinstay-owned data

The dashboard is the source of truth. Backups are useful, but they should never become the operating workspace.

Canonical home

Withinstay

Guest records, add-ons, consent and fulfilment stay in the dashboard.

External tools

Delivery only

Airbnb, Booking.com, Gmail and WhatsApp bring guests into the flow.

Backups

Optional

Google Sheets can receive a host-owned export copy when enabled.

Google Sheets backup

Hosts can connect a sheet when they want a backup copy or simple data access outside a paid tool. The sheet does not write back.

Guest arrivals

Guest arrivals!A:Z

Guest name, reservation channel, arrival date/time, contact fields and consent status.

Add-on requests

Add-on requests!A:Z

Requested massages, transfers, hampers, local experiences and fulfilment status.

Email events

Email events!A:Z

Resend lifecycle events for confirmations, hosted order emails and host alerts.

Sheets is a one-way backup/export, not the source of truth.
Editing the sheet does not update Withinstay records.
Exports should exclude sensitive wellness notes unless the host explicitly enables them.
Scheduled exports need retry/backoff and quota handling before production rollout.

Guest email flows

Resend owns the email lifecycle once a guest enters a Withinstay form or add-on order flow.

Open email engine

guest

Guest arrival confirmation

ready

Confirms the guest has entered the Withinstay flow and repeats the main arrival/add-on details.

Template env

RESEND_PREARRIVAL_GUEST_TEMPLATE_ID

host

Host arrival alert

ready

Notifies the host/operator that a guest submitted arrival details or requested add-ons.

Template env

RESEND_HOST_ALERT_TEMPLATE_ID

guest

Guest order confirmation

draft

Confirms hosted add-on orders, partner services and fulfilment updates after the request is accepted.

Template env

RESEND_ORDER_CONFIRMATION_TEMPLATE_ID

Security posture

Third-party account creation and OAuth authorization must happen through provider-owned flows where needed. Airbnb and Booking.com can start as copy-ready message templates that deliver the Withinstay form link, while Resend manages verified email sends and delivery webhooks. Google Sheets is a one-way backup only.

Server-only API tests
Hosted form submissions
Resend webhook verification
Internal data ownership
Platform-safe link delivery

Connect Google auth

Google sign-in is ready in the codebase, but the production credentials need to be added before hosts can create accounts.

Setup statusConfig needed

Add Google OAuth credentials, then hosts can sign in and complete setup.

Google auth setup

Add Google OAuth credentials

Create a Google OAuth web client, add the redirect URI below, then set the client ID and secret in Vercel.

DATABASE_URLConfigured
GOOGLE_CLIENT_IDMissing
Redirect URIhttps://withinstays.com/api/auth/google/callback