> ## Documentation Index
> Fetch the complete documentation index at: https://help.statisfy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Workspace Integration

> Connect Gmail and Google Calendar in a single OAuth connection. Pick exactly which permissions to grant — Read email, Read calendar, Send email on your behalf — and update them any time.

### 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

<Note>
  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.
</Note>

### Permissions You Choose

When you click Connect, the dialog shows three checkboxes. Tick only what you need — at least one must be selected.

| Permission                    | Default | What it enables                                                                                                                                                                     | Required for                                                                            |
| ----------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| **Read email**                | ✅ On    | Pulls 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**             | ✅ On    | Pulls 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** | ✅ On    | Lets 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.

<Warning>
  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.
</Warning>

#### 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](https://myaccount.google.com/connections) and remove Statisfy.

<Warning>
  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.
</Warning>

### Using Google Workspace in Agent Studio

Once connected with the right permissions, Google Workspace powers several Agent Studio components:

| Component                   | Permission Required       | What it does                                                                                                                              |
| --------------------------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Gmail Send V2**           | Send email on your behalf | Sends 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 V2** | Read email                | Pauses a flow until a recipient replies to an email previously sent by Gmail Send V2.                                                     |
| **Upcoming Meeting V2**     | Read calendar             | Triggers a flow when a calendar event matches a meeting segment — uses the connected user's calendar data.                                |
| **Meeting Segment V2**      | Read calendar             | Triggers on past meetings ingested from Google Calendar.                                                                                  |

See [Action Components](/agent-studio/automations/actions) for full configuration details.

### Troubleshooting

<Accordion title="Authorization failed">
  * 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.
</Accordion>

<Accordion title="Connection succeeded but emails or calendar events aren't appearing">
  * **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](https://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.
</Accordion>

<Accordion title="Gmail Send fails with &#x22;no Gmail connection&#x22; or &#x22;insufficient permissions&#x22;">
  * 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**.
</Accordion>

<Accordion title="Replies not detected by Gmail Reply Listener">
  * 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.
</Accordion>

<Accordion title="I unchecked a permission by mistake — how do I get it back?">
  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.
</Accordion>

### Need Help?

If you face any challenges with the Google Workspace integration, please contact [support@statisfy.com](mailto:support@statisfy.com). Our team will assist you.