Skip to main content
The Gmail connector indexes emails and threads from Google Workspace accounts using service account authentication with domain-wide delegation. Personal Gmail accounts are not supported.

​
What gets indexed

  • Email subjects and bodies
  • Email threads
  • Sender and recipient information
  • Labels
  • Email metadata
Emails remain private and are only searchable by the users who sent or received them.

​
Setup

1

Connect to Grapevine

  1. In Grapevine, go to Integrations and click on Gmail
  2. A service account and Pub/Sub topic will be automatically created for your organization
  3. Note the Client ID displayed on the screen
2

Configure domain-wide delegation

  1. Go to Google Workspace Admin Console
  2. Click Add new to create a new API client
  3. Enter the Client ID from Step 1
  4. Add the following OAuth scopes (comma-separated): 
    https://www.googleapis.com/auth/gmail.readonly,
https://www.googleapis.com/auth/admin.directory.user.readonly,
https://www.googleapis.com/auth/admin.directory.group.readonly
  5. Click Authorize
3

Enter admin email

  1. Return to the Grapevine integration page
  2. Enter your Google Workspace admin email address
  3. Click Save Configuration
4

Indexing begins

Grapevine will automatically begin indexing your Gmail content. The initial sync may take time depending on the size of your organization.

​
Permissions

The Gmail connector uses domain-wide delegation to access emails:
  • Service account impersonates each user to access their emails
  • Only works with Google Workspace accounts (not personal Gmail)
  • Requires Google Workspace admin privileges to configure

​
Sync behavior

The initial indexing process may take time depending on the size of your organization. Real-time updates are configured automatically via Gmail push notifications.
  • Initial sync - Begins automatically after setup completion
  • Ongoing syncs - Real-time updates via Gmail push notifications keep your index current
  • Webhook refresh - Notification channels refresh automatically every 7 days

​
Limitations

  • Only emails from the last 90 days are indexed
  • Only Inbox and Sent folders are indexed
  • Only Google Workspace accounts are supported (personal Gmail accounts are not supported)