Sync Gmail into your CRM (read-only recipe)

Audience: power users (Pay-as-you-go and up) · Recipe: Pull Gmail threads into your CRM read-only, so the email context lives next to the customer record.

Every sales rep knows the drill: a customer asks "what did we agree on the price?" and the answer is buried in a Gmail thread that only one person can see. The CRM record says Customer: Acme Corp — status: Negotiating, but the actual conversation lives somewhere else entirely. This recipe closes that gap. You connect your mailbox once, and FastYoke quietly links the emails you exchange with a customer to that customer's record — so the next person to open Acme Corp sees the correspondence right there.

The important promise up front: this is a read sync, not a mail client. FastYoke reads matching threads and files them next to the record. It never sends, replies, deletes, or edits anything in your mailbox. You keep sending mail from Gmail exactly as you do today.

What you'll build

By the end you'll have a CRM where opening a contact, customer, or company record shows the emails you've traded with that address — subject, date, and body — pulled straight from your Gmail account and kept up to date automatically. New replies land against the record within a few minutes of arriving in your inbox, no copy-pasting or BCC-to-CRM ritual required.

Before you start

• A FastYoke tenant with a CRM app that has contact, customer, or company records with email addresses on them. The connector matches against addresses already in your CRM — if a record has no email, there's nothing to link against.
• A Gmail account — either a personal Gmail or a Google Workspace mailbox. The account you connect is the one whose sent/received mail gets scanned.
• Access to your Yoke's connector settings. The email connector is a Pay-as-you-go-and-up feature; if you don't see it, check your plan or ask your workspace admin.
• A minute at the Google consent screen. You'll approve a read-only permission. FastYoke requests exactly one Gmail scope — read-only access — so Google will tell you the app can view your email and nothing more.

Steps

1. Open the connectors panel

In your Yoke, open Connectors (under the Yoke's settings). You'll see the available integrations, including Connect Gmail alongside Connect Outlook. If your workspace already has an Outlook mailbox linked, that's fine — Gmail and Outlook sync independently and store their emails separately, so connecting one never touches the other.

2. Connect Gmail and approve read-only access

Click Connect Gmail. You'll be handed off to Google's standard OAuth consent screen. Sign in to the mailbox you want to link, and approve the permission. The scope FastYoke asks for is gmail.readonly plus your basic profile (name and email) — Google's screen will phrase this as permission to view your email messages and settings. There is deliberately no "send," "compose," or "modify" scope in the request, which is why you can't send mail from FastYoke: the capability was never granted.

Once you approve, Google returns you to FastYoke and the connection shows as active.

3. Let the initial backfill run

FastYoke immediately starts a bounded backfill of your recent mail. Rather than pulling your entire mailbox, it scans a recent window of messages, reads only the message headers first, and checks each sender/recipient address against the addresses in your CRM. This is the crucial filter: only messages that involve someone already in your CRM are ever downloaded in full. If an email has no CRM match — a newsletter, a personal note, a vendor you've never added — its body is never fetched or stored. FastYoke sees the header, finds no match, and moves on.

For matched messages, FastYoke fetches the full body, strips it to readable text, and files it against the matching record. The first pass usually links your recent customer emails within a few minutes. Larger mailboxes take a little longer as the backfill pages through in batches.

4. Open a record and read the thread

Now open a customer, contact, or company record that you've actually emailed. The correspondence appears on the record — subject line, date, sender, and the message body — grouped by the thread it belongs to. What was a private thread in one person's inbox is now shared context on the record itself. A teammate covering for you, or a manager reviewing the account, sees the same history without ever needing access to your mailbox.

5. Confirm it stays current

You don't have to do anything to keep it fresh. After the backfill, FastYoke tracks an incremental cursor against Gmail and picks up newly arrived messages on a short cycle. Send or receive a new email with a customer, wait a few minutes, and refresh the record — the new message shows up. Because it's cursor-based rather than a full rescan, it stays cheap and current without hammering your mailbox.

Take it further

• Add both mailboxes. If some of your team lives in Outlook or Microsoft 365, connect that too. Each mailbox syncs and is stored under its own account, so a shared customer record can accumulate correspondence from several reps across both providers.
• Keep addresses on your records tidy. The match is only as good as the email addresses in your CRM. If a customer emails from a personal address that isn't on their record, add it — the connector will start linking that address's mail on the next pass. This makes address hygiene a small but real lever on how complete the correspondence history looks.
• Encrypted at rest, and reversible. Synced message bodies are encrypted where they're stored, and everything is scoped to your tenant — one workspace's mail is never visible to another. If you ever want to walk it back, Disconnect stops the sync while keeping what's already linked, and Purge synced emails permanently deletes every message FastYoke stored from that mailbox. Purge is per-provider, so purging Gmail leaves any Outlook history untouched.
• Scale it across the team. Each rep connects their own mailbox; the records they share accumulate a fuller picture as more mailboxes come online. From a solo operator to a full sales floor, the same read-only guarantee holds — no mailbox is ever writable from FastYoke, and no non-customer email is ever downloaded.

Related

• Email Connector (Gmail & Outlook) — the reference doc for connecting, disconnecting, and purging.
• Your CRM app's records view, where the linked correspondence appears next to each contact, customer, and company.