← Back to Documentation
🔵

Google Connector Setup

Connect Gmail, Google Calendar, Drive, Docs, Sheets, Slides, Contacts, Tasks, and other Google services to your Sontairo workspace. This guide walks you through creating a Google Cloud project and OAuth 2.0 credentials.

Prerequisites

Step 1: Create a Google Cloud Project

  1. Go to the Google Cloud Console — Create Project
  2. Enter a project name (e.g., "Sontairo Integration")
  3. Click Create
  4. Wait for the project to be created, then make sure it's selected in the top navigation bar

Step 2: Enable APIs

Enable the APIs for the Google products you want to use. You only need to enable the APIs for the products you plan to connect:

Gmail API

  1. Go to Gmail API page
  2. Click Enable

Google Calendar API

  1. Go to Calendar API page
  2. Click Enable

Google Drive API

  1. Go to Drive API page
  2. Click Enable

Google Sheets API

  1. Go to Sheets API page
  2. Click Enable

Google Docs API

  1. Go to Docs API page
  2. Click Enable

Google Slides API

  1. Go to Slides API page
  2. Click Enable

People API (Contacts)

  1. Go to People API page
  2. Click Enable

Google Tasks API

  1. Go to Tasks API page
  2. Click Enable

Step 3: Configure OAuth Consent Screen

  1. Go to OAuth consent screen
  2. Select External user type (or Internal if paying for Google Workspace)
  3. Click Create
  4. Fill in the required fields:
    • App name: Sontairo
    • User support email: Your email
    • Developer contact email: Your email
  5. Click Save and Continue
  6. On the Data Access page, click Add or Remove Scopes and add the scopes for the products you plan to use. You can find each product's required scope listed in the Sontairo connector configuration dialog (Step 5) next to the product name.
  7. Click Save and Continue through the remaining pages

Step 4: Create OAuth 2.0 Credentials

  1. Go to Credentials page
  2. Click + Create Credentials → OAuth client ID
  3. Select Web application as the application type
  4. Enter a name (e.g., "Sontairo OAuth Client")
  5. Under Authorized redirect URIs, add your Sontairo callback URL:
    https://your-domain.com/api/oauth/callback

    Replace your-domain.com with your actual Sontairo domain. For local development, use http://localhost:3000/api/oauth/callback

  6. Click Create
  7. Copy the Client ID and Client Secret — you'll need these in the next step

Step 5: Configure in Sontairo

  1. In Sontairo, go to Connectors in the sidebar
  2. Click Add Connector and select Google
  3. Enter a display name (e.g., "My Google Account")
  4. Click on the connector card's Configure button
  5. Select which Google products to enable (Gmail, Calendar, Drive, Sheets, Docs, Slides, Contacts, Tasks)
  6. Paste your Client ID and Client Secret
  7. Click Save Configuration
  8. Click Authorize with Google on the connector card — you will be redirected to Google to grant access
  9. After authorizing, you will be returned to the Connectors page with a confirmation message

⚠️ Publishing Your App

While in testing mode, only test users you've added can authorize the app. To allow any Google account to connect, you'll need to submit your app for Google's verification review. For personal or small team use, adding yourself as a test user is sufficient.

💡 Add Test Users

Go to the OAuth consent screen → Test users → Add Users and add the Google accounts that need access.

Having trouble? Check the Troubleshooting guide for common issues and solutions.