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

# Gmail

> Connect Gmail per user to bring recent customer email threads into Hyperline, so the customer monitoring agent can weigh relationship signals.

[Gmail](https://mail.google.com) is Google's email service. Connecting it lets Hyperline read the email threads you exchanged with your customers, so the customer monitoring agent can weigh how a relationship is going alongside contract, invoice, payment, and usage data.

<Info>
  Gmail is part of [Customer intelligence](../docs/customer-intelligence/overview), a paid add-on. Contact the Hyperline team through the in-app chat to enable it.
</Info>

<Note>
  Gmail is **user-scoped**: each teammate connects their own mailbox from **Profile > Integrations**, not from the workspace-level **Settings > Integrations** page. Hyperline only sees the mailboxes of the users who connected.
</Note>

## Prerequisites

A Google account with the mailbox you want Hyperline to read.

## Connect Gmail

<Steps>
  <Step title="In Hyperline, open Profile > Integrations" />

  <Step title="Click Connect on Gmail" />

  <Step title="Choose your Google account and review the requested access" />

  <Step title="Confirm">
    You are redirected back to Hyperline and the connection appears as active for your user.
  </Step>
</Steps>

<Tip>
  Gmail and [Google Meet](./google-meet) are two separate connections that share nothing. You can share your calendar and meetings without sharing your mailbox, and the other way round.
</Tip>

### Requested permissions

Hyperline requests read-only access to Gmail, plus your basic profile information to identify the connected account. The connection never sends, replies to, deletes, or modifies anything in your mailbox.

## What Hyperline fetches

Hyperline never reads your whole mailbox. It searches Gmail once per customer domain, for messages sent to or received from that domain, and keeps only the results that match a known customer.

For every matched email, Hyperline stores:

| Data         | Details                                                               |
| ------------ | --------------------------------------------------------------------- |
| Thread       | The Gmail thread identifier, so messages stay grouped by conversation |
| Subject      | The subject line                                                      |
| Participants | Sender name and address, recipients, and copied addresses             |
| Body         | The message content                                                   |
| Date         | When the message was received                                         |

Emails that do not match a customer domain are discarded and never stored.

<Tip>
  Keep customer **Domain** values up to date. The domain is what decides which searches run and which messages are kept.
</Tip>

## Synchronization

Hyperline synchronizes mailboxes once a day, for every user who connected their Google account. The recurring run looks one day back, so it only picks up new messages.

A full-history search runs instead when the sync is scoped to a single domain, for example when a customer is created. That search is capped per domain, so a very large history is not retrieved in full.

## Where Gmail data appears

* **Customer page**: the **Integrations** section shows a Gmail row with the most recent email. Open it to browse synced threads and their content.
* **Monitoring agent**: email is handled separately from the other connectors. When Gmail is connected for users in your workspace, the agent can use recent customer email threads without a toggle in the agent's **Connectors** tab.
* **Analysis results**: Gmail appears under **Data sources** when email context was used.

## Manage the connection

Open **Profile > Integrations** to review or remove your own connection. Disconnecting stops Hyperline from reading your mailbox.

Each teammate manages their own connection, so removing yours does not affect anyone else's.

## Related

* [Google Meet](./google-meet)
* [Customer intelligence](../docs/customer-intelligence/overview)
* [Customer monitoring agent](../docs/customer-intelligence/customer-monitoring-agent)
* [Integrations overview](./overview)