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

# Gmail Integration

> Connect your Google email account to send, sync, and manage emails from Raycaster

## Overview

The Gmail integration connects your Google email account to Raycaster, letting you send emails, sync your inbox, and run email sequences — all without leaving your workspace.

<img src="https://mintcdn.com/raycaster/NkwkAu8IAZ9zTAYr/gmail-integration.png?fit=max&auto=format&n=NkwkAu8IAZ9zTAYr&q=85&s=9d943b85369b4d0407dc20a1598a748e" alt="Gmail Integration Setup" width="1357" height="635" data-path="gmail-integration.png" />

## Setting Up Gmail

<Steps>
  <Step title="Open Integration Settings">
    Navigate to **Settings → Integrations** in the sidebar.
  </Step>

  <Step title="Add Gmail">
    Find the Google section and click **"Add Integration"** (or **"Add Another Account"** if you already have one connected).
  </Step>

  <Step title="Choose Scope">
    Select how this account should be shared:

    * **Personal** — Only you can send from and view emails for this account
    * **Organization** — All team members can use this account

    <Tip>
      Use **Personal** for your individual work email. Use **Organization** for a shared team inbox like `sales@yourcompany.com`.
    </Tip>
  </Step>

  <Step title="Sign In">
    Click to authorize with Google. You'll be redirected to Google's sign-in page to grant permission.

    **Permissions requested:**

    * Read your emails
    * Send emails on your behalf
    * Manage email labels
  </Step>

  <Step title="Confirmation">
    Once authorized, the integration becomes active. You'll see a green status indicator with your connected email address.
  </Step>
</Steps>

<Frame caption="Gmail integration settings showing connected accounts and management options">
  <img src="https://mintcdn.com/raycaster/_VVk1UxeaQQsf887/images/edit-integrations.png?fit=max&auto=format&n=_VVk1UxeaQQsf887&q=85&s=57fa0b22e740199abbe3dc86d1799967" alt="Gmail integration management" width="3024" height="1964" data-path="images/edit-integrations.png" />
</Frame>

## Multiple Accounts

Gmail supports connecting multiple accounts. For example, you might connect:

* Your personal work email as a **Personal** integration
* A shared team email as an **Organization** integration

Each account operates independently with its own connection and scope settings.

## Syncing Emails

Once connected, you can sync your Gmail inbox to Raycaster:

* **Manual sync** — Click the **Sync** button on the integrations page to pull in recent emails on demand
* **View emails** — Navigate to the Emails page (`/emails`) to see all synced emails
* **Search** — Search across all synced emails from within Raycaster

### Sync Details

* Emails are transformed into a unified format for consistent display
* Read/unread status is preserved
* Threaded conversations are maintained
* Sync includes recent emails (configurable time range)

## Sending Emails

With Gmail connected, you can send emails from:

* **Sheet Email Composer** — Select rows and compose emails with variables
* **Email Sequences** — Automated multi-step campaigns
* **AI Chat** — Ask the AI assistant to send emails on your behalf

All sent emails appear in both your Gmail Sent folder and Raycaster's Emails page.

## Status Monitoring

The integrations page shows real-time status for each Gmail connection:

| Indicator           | Meaning                                                            |
| ------------------- | ------------------------------------------------------------------ |
| **Green checkmark** | Active and working. Shows connected email and total emails synced. |
| **Gray circle**     | Not connected or inactive.                                         |
| **Red alert**       | Error detected. Check error details for troubleshooting.           |

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth authorization fails">
    * Verify you're signing in with the correct Google account
    * Check that you've granted all requested permissions
    * Try disconnecting and reconnecting the integration
    * Clear your browser cache and try again
  </Accordion>

  <Accordion title="Emails not syncing">
    * Click the manual **Sync** button to trigger a fresh sync
    * Verify the integration shows an active (green) status
    * Check if the connected email address is correct
    * If the issue persists, disconnect and reconnect the integration
  </Accordion>

  <Accordion title="Emails failing to send">
    * Confirm the integration is still active (token may have expired)
    * Verify the recipient email address is valid
    * Check the failed email's error details on the Emails page
    * Reconnect the integration if the auth token has expired
  </Accordion>
</AccordionGroup>

## Disconnecting

To remove a Gmail connection:

1. Go to **Settings → Integrations**
2. Find the Gmail integration you want to remove
3. Click **Disconnect** (or the uninstall button)
4. Confirm the removal

<Warning>
  Disconnecting an integration does not delete previously sent emails or synced data. It only prevents future sending and syncing from that account.
</Warning>