> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yuzulabs.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Gmail
> Connect Gmail so Yuzu can send tracked email, backfill contact history, and detect buyer replies.
Gmail turns email into a first-class Yuzu signal source.
## What Gmail enables
When Gmail is connected, Yuzu can:
* Send tracked email from the seller's mailbox.
* Schedule reviewed email drafts to send later.
* Persist outbound replies back into Yuzu threads.
* Open deal-native email review for generated follow-up drafts.
* Backfill historical conversations for a person.
* Backfill deal contact conversations when a deal arrives from a CRM integration.
* Detect inbound replies and attach them to the right thread.
* Count opens and clicks for tracked sends.
* Queue agent-drafted sends for approval when email autopilot is off.
## Required scopes
Yuzu checks for two Google scopes:
* `gmail.send`: required to send email from the connected mailbox.
* `gmail.readonly`: required for backfill, thread reads, and inbound sync.
If either badge is missing on **Settings → Email**, update Google access from the connection card.
## People backfill
On a person's **Emails** tab, Yuzu can search Gmail for existing messages to or from that person's email address. Backfill is deduped by Gmail message ID and scoped to the signed-in user.
Backfilled messages can also help Yuzu infer deal relationships when the same email address appears on a deal. That keeps a person added from Gmail from looking disconnected from the buyer work already happening in Yuzu.
## Deal emails
Deal pages show deal-scoped email threads: emails Yuzu sent for that deal, replies linked back to the same deal, and Gmail messages found for the deal's contacts.
If Monaco or Attio has already imported email activity for the deal, those rows show as source-labeled copies. Gmail rows show the **Gmail** source label and are preferred because they can open the full thread and send replies. When the same email exists in Gmail and in Monaco or Attio, Yuzu suppresses the provider copy so the deal page does not show duplicates.
Deal email drafts open in the same review surface as package and next-action emails. Sellers can edit the recipients, subject, and body, then send or schedule without leaving the deal.
## Approval queue
When email autopilot is off, agent-drafted sends wait for human approval. Review the draft, approve it, or discard it.
The approval queue is a fallback and admin surface. The primary review path for deal-generated email is the deal page or the people thread that created the draft.
## Scheduled sends
Scheduled sends use the same Gmail connection as immediate sends. Yuzu stores the requested send time on the draft, then a scheduled worker sends from the connected mailbox and records the Gmail message ID on the sent email row.
If the Google token is missing or the `gmail.send` scope is unavailable when the scheduled time arrives, Yuzu keeps the draft and records the error so the seller can reconnect Gmail and schedule again.
Gmail does not make one user's mailbox visible to every teammate. Email enrichment is scoped to the connected user.