Google Authentication
Set up shared Google OAuth authentication for Gmail, Google Calendar, Google Chat, Google Docs, Google Drive, and Google Sheets.
Use this guide when you connect a Google integration in Kognitos with Continue with Google.
You can create one Google OAuth app in Google Cloud and reuse the same Client ID and Client Secret across these integrations:
Google Docs, Google Drive, and Google Sheets also support service account authentication. This page covers the shared OAuth setup that works across all six Google integrations. For service account setup, see Google Service Account Authentication.
Before You Start
Make sure you have:
Access to a Google Cloud project, or permission to create one
Permission to configure the Google Auth Platform and create OAuth clients
Access to the Kognitos workspace where you want to add the connection
If your organization wants to avoid Google's unverified app warning, create the OAuth app as an Internal app in your Google Workspace organization.
Set Up the OAuth App in Google Cloud
Create or select a Google Cloud project
In Google Cloud Console, create a new project or open an existing one that will own the OAuth app.
Configure the consent screen
In Google Auth Platform, set up the consent screen for the project:
Enter an app name.
Select a user support email.
Choose Internal as the audience if the app should only be used by people in your Google Workspace organization.
Add a contact email.
Accept Google's user data policy and save the configuration.
Create the OAuth client
Create a new client with these settings:
Application type: Web application
Authorized redirect URI:
https://app.us-1.kognitos.com/oauth/connections/callback
Copy the Client ID and Client Secret after you create the client. Store the secret somewhere secure in case Google only shows it once.
Use the production redirect URI exactly as shown. Do not use the dev URL or a legacy callback URL.
Enable the APIs you need
In APIs & Services → Library, enable the APIs for the Google integrations you plan to use:
Gmail API
Google Calendar API
Google Chat API
Google Docs API and Google Drive API
Google Drive API
Google Sheets API
If you plan to use several Google integrations, enable all of their APIs in the same project.
If you use Google Chat, open the Google Chat API configuration after you enable the API and complete the app details before you connect it in Kognitos:
App name: for example,
KognitosAvatar URL:
https://www.kognitos.com/img/favicon.svgDescription: for example,
Google Chat integration with KognitosEnable Build this Chat app as a Workspace add-on
Disable Interactive features
Use the Credentials in Kognitos
After you create the OAuth client in Google Cloud, connect each Google integration in Kognitos with the same credentials.
Open the integration
In Kognitos, go to Integrations → Explore Integrations, then open the Google integration you want to connect.
Start a new connection
Click Connect, add a connection name, and choose the OAuth option if Kognitos asks you to select an authentication method.
Enter your OAuth client details
Paste the Client ID and Client Secret from Google Cloud.
Authorize with Google
Click Continue with Google, sign in to Google, grant access, and return to Kognitos.
Repeat this for each Google integration you want to connect. You can reuse the same OAuth app across all six integrations.
Troubleshooting
Redirect URI mismatch
Confirm the redirect URI is exactly https://app.us-1.kognitos.com/oauth/connections/callback
Unverified app warning
Make sure the OAuth app audience is set to Internal, and the user belongs to the same Google Workspace organization
Access blocked
Verify that the API for the integration is enabled in the Google Cloud project
Missing client secret
Create a new client secret in Google Cloud, then update the connection in Kognitos
Related Integration Pages
Last updated
Was this helpful?