Skip to main content

​
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. Gmail Integration Setup

​
Setting Up Gmail

1

Open Integration Settings

Navigate to Settings → Integrations in the sidebar.
2

Add Gmail

Find the Google section and click “Add Integration” (or “Add Another Account” if you already have one connected).
3

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
Use Personal for your individual work email. Use Organization for a shared team inbox like sales@yourcompany.com.
4

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
5

Confirmation

Once authorized, the integration becomes active. You’ll see a green status indicator with your connected email address.
Gmail integration management

​
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:
IndicatorMeaning
Green checkmarkActive and working. Shows connected email and total emails synced.
Gray circleNot connected or inactive.
Red alertError detected. Check error details for troubleshooting.

​
Troubleshooting

  • 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
  • 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
  • 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

​
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
Disconnecting an integration does not delete previously sent emails or synced data. It only prevents future sending and syncing from that account.