Skip to main content

​
Connect Google Workspace with Statisfy

The Google Workspace integration links your Gmail and Google Calendar to Statisfy through a single OAuth connection. You choose exactly which permissions to grant at connect time, and can change them later. Once connected, Statisfy can:
  • Sync your email threads in near real-time (when Read email is granted)
  • Pull historical and ongoing calendar events (when Read calendar is granted)
  • Send emails from your Gmail account via Workbench or the Gmail Send V2 Agent Studio component (when Send email on your behalf is granted)
  • Listen for replies via the Gmail Reply Listener V2 component (uses Read email)
  • Power role-based sends so workflow emails appear to come from the right team member
Google Workspace is a per-user integration — each user who wants Statisfy to act on their behalf must connect their own Google account. Connecting yours does not give Statisfy access to your teammates’ Gmail or Calendar.

​
Permissions You Choose

When you click Connect, the dialog shows three checkboxes. Tick only what you need — at least one must be selected.
PermissionDefaultWhat it enablesRequired for
Read email✅ OnPulls inbound and outbound Gmail messages so customer conversations attach to the right accounts and people. New messages stream in within seconds via Google’s push notifications.Email timeline, Gmail Reply Listener V2, Stella conversation context
Read calendar✅ OnPulls upcoming and past Google Calendar events, links them to customer records, and lets Statisfy run meeting-based triggers.Upcoming Meeting V2 / Meeting Segment V2 triggers, Statisfy notetaker, meeting timeline
Send email on your behalf✅ OnLets Statisfy send emails from your Gmail address — only when you trigger them through Stella, Agent Studio flows, or the Statisfy email composer.Gmail Send V2, Stella drafts, automated outreach flows you set up
You can grant any combination — including just one. Statisfy never requests a permission you didn’t check. Statisfy never reads, indexes, or stores email content beyond what is needed to attach messages to the right customer record and detect replies to outreach you explicitly initiated through Statisfy.

​
Prerequisites

  • A Google Workspace account (consumer gmail.com accounts also work)
  • The Statisfy admin must have enabled the Google Workspace integration in your org
  • A connected CRM (Salesforce or HubSpot) — non-CRM integrations are gated until at least one CRM sync has completed
  • Pop-ups allowed for Statisfy in your browser (the Google sign-in opens in a new window)

​
Steps to Connect

  1. Log in to Statisfy.
  2. Navigate to Integrations → User Apps → Google Workspace.
  3. Click the Google Workspace card. The connect dialog appears with the three permission checkboxes (defaults: Read email ✅, Read calendar ✅, Send email ✅).
  4. Tick or untick the boxes to match what you want Statisfy to do.
  5. Click Connect your account.
  6. A Google sign-in window pops up. Sign in if needed, then review the requested permissions — they’ll match exactly what you checked. Click Continue → Allow.
  7. The pop-up closes automatically. The Google Workspace card will show Connected within a few seconds.
A one-time 30-day backfill runs for each surface you granted (email and/or calendar). After that, Statisfy stays in sync via Google’s push notifications — new messages and events arrive within seconds.

​
Managing Your Connection

​
Adding or removing permissions later

  1. Go to Integrations → User Apps → Google Workspace.
  2. Click the Google Workspace card. The Manage dialog opens with your current permissions pre-checked.
  3. Tick or untick the boxes to change what Statisfy can access.
  4. Click Update permissions.
  5. Re-authorize in the Google pop-up. Google will only ask you to confirm the new permission set.
What happens:
  • Adding a permission (e.g. enabling Read calendar): Statisfy starts syncing that surface within seconds and runs a 30-day backfill.
  • Removing a permission (e.g. unchecking Read email): Statisfy immediately stops pulling new data for that surface. Previously synced data stays in your customer timelines — Statisfy doesn’t delete history.
If you remove Send email on your behalf from a user whose account powers an active Gmail Send V2 flow, sends from that flow will start failing. Either re-grant send permission, or reassign the flow’s sender to another user who still has it.

​
Disconnecting entirely

  1. Open the Google Workspace card.
  2. Click Disconnect.
Statisfy immediately stops syncing your Gmail and Calendar. Historical data already pulled stays in your timelines. To fully revoke Statisfy’s access on Google’s side too, also visit myaccount.google.com/connections and remove Statisfy.
Disconnecting Google Workspace pauses any active automations that depend on your Gmail or Calendar (e.g., Gmail Send V2 flows you authored). Reconnect or reassign those flows to another user to keep them running.

​
Using Google Workspace in Agent Studio

Once connected with the right permissions, Google Workspace powers several Agent Studio components:
ComponentPermission RequiredWhat it does
Gmail Send V2Send email on your behalfSends an email as the connected user. Use Send As Role (e.g., Account Owner, CSM) to pick the right sender per account automatically.
Gmail Reply Listener V2Read emailPauses a flow until a recipient replies to an email previously sent by Gmail Send V2.
Upcoming Meeting V2Read calendarTriggers a flow when a calendar event matches a meeting segment — uses the connected user’s calendar data.
Meeting Segment V2Read calendarTriggers on past meetings ingested from Google Calendar.
See Action Components for full configuration details.

​
Troubleshooting

  • Make sure pop-ups and third-party cookies aren’t blocked for statisfy.com and accounts.google.com.
  • If your admin restricts third-party app access in Google Admin Console, ask them to allow Statisfy in Security → API controls → App access control.
  • Retry the OAuth flow — the authorization code is short-lived and expires after a few minutes.
  • Check which permissions you granted. Open the Google Workspace card — if only Read calendar is ticked, you won’t see emails (and vice versa). Re-open the dialog, tick the right box, and click Update permissions.
  • Wait a couple of minutes for the 30-day backfill to complete.
  • Confirm on Google’s side — visit myaccount.google.com/connections. Statisfy should appear with the scopes you granted.
  • Verify your CRM integration has completed at least one successful sync — non-CRM data is gated on CRM completion.
  • For calendar events specifically: the meeting needs at least one external attendee whose domain matches a known account.
  • The user selected via Send As Role must have personally connected their Google Workspace account with Send email on your behalf ticked.
  • Connecting under a shared admin account does not grant send rights for other team members.
  • Ask the relevant user to visit Integrations → User Apps → Google Workspace and either click Connect (if not yet connected) or open the manage dialog and tick Send email on your behalf, then click Update permissions.
  • The connected user must have Read email granted — check via the manage dialog that the box is still ticked.
  • The reply has to land in the same Gmail thread Statisfy sent from. Forwarded replies from a separate address are not matched.
Open Integrations → User Apps → Google Workspace, tick the missing permission, and click Update permissions. Google will re-prompt for that specific scope. Already-synced historical data remains intact; ongoing sync resumes immediately.

​
Need Help?

If you face any challenges with the Google Workspace integration, please contact support@statisfy.com. Our team will assist you.