Skip to contentSkip to Content
Integrations

Google Workspace

For most clients, Google Workspace is where the raw material of their workflows lives — invoices arrive in Gmail, processes run on Sheets, documents sit in Drive. Connecting it is done by your FDE as part of a build, scoped to the specific mailboxes, folders, and files a workflow needs. There is no self-serve OAuth flow in the client portal today.

What it enables

The most common Google Workspace-backed builds (see workflow automation):

  • Email processing — sorting, categorizing, and routing messages in a mailbox based on content and intent, such as an accounts@ or support@ inbox.
  • Data extraction from email and documents — pulling information out of attachments and Drive files (invoices, contracts, applications) into your systems automatically.
  • Report generation and delivery — scheduled or on-demand reports written to Docs or Sheets, in a folder your team already checks.
  • Data imports from Sheets — using spreadsheets your team maintains as live inputs to workflows and dashboards.
  • Scheduling and coordination — automated booking, reminders, and follow-ups built on your calendars.

What access your FDE will request

Access is scoped per workflow, not granted wholesale. Typical requests look like:

  • Read access to a specific mailbox for an email-processing workflow — not your whole domain’s mail.
  • Read or write access to named Drive folders — a watched intake folder, an output folder for generated reports.
  • Access to specific Sheets that act as workflow inputs or outputs.
  • Send-as access on a specific mailbox, only when a workflow actually sends email.

Each request names the workflow it serves, so you can match access to purpose. Depending on your setup, granting it may involve your Google Workspace admin approving access or sharing the relevant folders and files with a dedicated account — your FDE will walk your admin through the exact steps for your domain.

Prerequisites

PrerequisiteWhy it matters
A Google Workspace admin available to grant accessMost grants need admin approval; the build stalls without them
Clarity on which mailboxes, folders, and Sheets are in scopeScoped access can’t be requested until you’ve named the targets
A shared folder for workflow outputsGenerated reports need a home your team will actually check
Reasonably tidy source dataA Sheet with merged cells and three header rows fights automation — see the data preparation guide

What the process looks like

Scoped with the workflow

Your FDE identifies exactly which mailboxes, folders, and files the workflow reads and writes, and confirms them with you.

Access request sent

You receive the scope list — what, why, and for which workflow. Your admin grants access or shares the named resources.

Tested against real data

The workflow runs against the live mailbox or folder in a controlled way — outputs to a test location first — so extraction quality and edge cases surface before go-live.

Live, monitored, documented

Outputs move to their real destinations. The connection is documented, and runs are visible in Runs.

Troubleshooting basics

  • A workflow stopped processing email or files. The usual causes: access was revoked, the account whose access the workflow uses was suspended or had credentials reset, or the watched folder/label was renamed or moved. Check whether the resource still exists under the same name, then check Runs.
  • Reports stopped appearing in the folder. Confirm the output folder wasn’t moved or had sharing changed; folder restructures are the most common silent breaker.
  • Extraction quality dropped. Often a change in the source — a supplier redesigned their invoice layout, a Sheet gained a new column. Send your FDE a recent example in Chat; workflows are updated as your inputs evolve.
  • Security review questions from your admin. Your FDE can provide the scope list, what each scope is used for, and the data-handling terms — see data and privacy.

Next steps

Last updated on