Back to Guides
Online appointments

Online appointments — connecting Google Meet

One-time OAuth connection so every virtual booking auto-creates a Meet room in your Google Calendar.

Connecting Google Meet takes 30 seconds once your platform admin has set up Google OAuth in the environment. (If you self-host, ask the engineer running your Trimsy instance whether GOOGLE_OAUTH_CLIENT_ID is configured — the settings panel shows a yellow "not configured" message if it isn't.)

Connect

  1. Go to Settings → Booking → Online Appointments.
  2. Pick Google Meet — auto-create a Meet room from the provider dropdown.
  3. A "Connect Google Account" panel appears below. Click the button.
  4. A Google sign-in popup opens. Pick the account you want meetings created under.
  5. Approve the requested permissions:
    • See, edit, share, and permanently delete all the calendars you can access using Google Calendar — Trimsy needs this to create event objects with conference data attached. We only create events for virtual bookings; we never read or modify your existing calendar entries.
    • See your primary Google Account email address — used to display "Connected as [email protected]" in settings.
  6. The popup closes automatically. The settings panel refreshes to show "Connected — [email protected]".

How it works after that

Every virtual booking from then on calls Google Calendar's events.insert endpoint with conferenceData.createRequest. Google generates a Meet room and returns a hangoutLink, which Trimsy stores on the booking and includes in the confirmation email, SMS, and customer portal.

Each meeting also lands as an event on the connected Google Calendar with the customer's name in the title and the booking reference in the description, which is useful as a backup record.

Disconnecting

Click Disconnect in the same settings panel. Future bookings stop generating Meet links and fall through to the Not set state until you reconnect or switch provider. Existing meeting links stay valid — disconnect doesn't revoke them.

Troubleshooting

  • "Could not obtain a refresh token" on connect — happens occasionally with reused consents. Visit Google Account → Security → Third-party access, revoke Trimsy, then reconnect.
  • Bookings created but no link attached — check Settings → Booking still shows "Connected". Tokens can be revoked from the Google side; reconnect if so.
  • Token refresh failures (after 6 months idle) — Google expires refresh tokens that haven't been used in 6 months. Reconnect once and the cycle restarts.