← Back to Integrations ← Back to Portal
🔵

Google Workspace

Productivity & Collaboration

Google Workspace APIs — Gmail, Calendar, Drive, Contacts, Meet, and Google Business Profile

Not Configured

🔵 Available Google APIs

📧 Gmail
Read, send, draft, and manage email. Apply labels, manage threads, and handle attachments.
📅 Google Calendar
Create, update, and delete events. Manage attendees, check availability, and handle recurring events.
📁 Google Drive
Upload, download, share, and organise files. Manage permissions and shared drives.
👥 Google Contacts
Access and manage contacts, contact groups, and "other contacts" directory.
🎥 Google Meet
Create meeting links, schedule video conferences, and manage meeting settings.
🏢 Google Business Profile
Manage business listings, respond to reviews, update hours, and post updates.

🔧 Connection Settings

Google Cloud Console project ID
Service account email from your JSON key file
The full JSON key file or the private_key field value (begins with -----BEGIN PRIVATE KEY-----)
The email of the user to impersonate (must have Google Workspace admin enable domain-wide delegation)
Calendar to use by default (leave empty for primary calendar)

📋 Saved Connections

Loading...
  1. Go to Google Cloud Console → Create a new project (or select an existing one)
  2. Enable the required APIs:
    • Gmail API
    • Google Calendar API
    • Google Drive API
    • People API (for Contacts)
    • Google Meet REST API (optional)
    • My Business Business Information API (optional)
  3. Go to IAM & Admin → Service Accounts → Create a new service account
  4. Name it sarah-voice, grant no special roles (optional: Project → Viewer)
  5. Click the service account → Keys → Add Key → Create new key → JSON
  6. Download the JSON key file — this contains your project_id, client_email, and private_key
  7. For Google Workspace users (Gmail, Calendar, etc.):
    • Go to Google Admin Console → Domain-wide Delegation
    • Click "Add new"
    • Client ID: Copy from your service account details (numeric ID)
    • OAuth Scopes: paste all required scopes: https://www.googleapis.com/auth/gmail.modify, https://www.googleapis.com/auth/gmail.send, https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/drive, https://www.googleapis.com/auth/contacts, https://www.googleapis.com/auth/meetings.space.created
    • Click Authorize
  8. Impersonate User: Enter the email of the Workspace user whose data SARAH should access (e.g., admin@yourdomain.com)
  9. Paste the JSON key (or individual fields) above and click Test Connection
  1. If you're using a personal Gmail (not Google Workspace), use OAuth2 instead of service account
  2. In Google Cloud Console → APIs & Services → Credentials → Create Credentials → OAuth client ID
  3. Application type: Web application
  4. Authorized redirect URI: https://your-sarah-domain.com/api/admin/google/oauth/callback
  5. Copy the Client ID and Client Secret
  6. OAuth2 flow support coming soon — for now, service account with domain-wide delegation is recommended