> ## Documentation Index > Fetch the complete documentation index at: https://docs.stackone.com/llms.txt > Use this file to discover all available pages before exploring further. # Google Chat OAuth 2.0 connector profile – StackOne setup guide > Set up the OAuth 2.0 connector profile for Google Chat in StackOne. One-time admin setup required before your users can link Google Chat accounts via Hub. A Google Cloud project with Owner or Editor permissions is required to create OAuth credentials.
Select Actions to adjust the guide
Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.
Action
Scope(s)
Loading actions...
Dynamic Guide URL
Scopes Selected

          

            
Separator

Create or select a Google Cloud project

To use the Google Chat API with OAuth 2.0, you need a Google Cloud project.

Sign in to your Google Cloud Console.

Google Cloud Console login

Select an existing project from the dropdown at the top of the page, or create a new one by clicking New Project and filling in the Project name, Organization, and Parent resource fields, then clicking Create.

Google Cloud Console welcome page with project selector

Enable the Google Chat API

Enable the Google Chat API for your project. This step is required whether you created a new project or selected an existing one.

In the Google Cloud Console, navigate to APIs & Services > Library.

Search for "Google Chat API" and click on it.

  • New project: Click Enable to activate the API.
  • Existing project: If the API is already enabled, the button will show Manage. If it shows Enable, click it to enable the API.
Google Chat API product details page showing Enable and Manage buttons

Configure Chat API Basic Settings

Configure the Chat app on the Google Chat API Configuration page. This step is required for the Google Chat endpoints to function correctly. StackOne uses REST API access only and does not receive incoming events; however, Google requires a configured Chat app with a valid HTTPS endpoint URL to enable API access.

Navigate to APIs & Services > Enabled APIs & Services, select Google Chat API from the list, then open the Configuration tab and fill in the required fields.

  • App status (if visible): Set to LIVE - available to users.
  • App name: Display name for your application (up to 25 characters).
  • Avatar URL: HTTPS URL to a square image (PNG/JPEG, 256x256 pixels).
  • Description: Brief description (up to 40 characters).
  • Interactive features: Enable this option if your app will use interactive cards or dialogues.
  • Select Join spaces and group conversations.
  • Connection settings: Select HTTP endpoint URL.
  • Triggers: Select Use a common HTTP endpoint URL for all triggers and enter any valid HTTPS URL (e.g., `https://yourdomain.com`). A valid endpoint URL is required to save the configuration.
  • Visibility: Set the visibility of your app and add email addresses to make it available to specific users or groups if needed.
  • Select Log errors to Logging for debugging purposes if required.
  • Click Save.
Google Chat API Configuration tab showing App status, Application info, and connection settings

Configure Google Auth Platform

Before creating OAuth credentials, ensure the Google Auth Platform is configured for your project.

In the Google Cloud Console, go to APIs & Services > OAuth consent screen from the left sidebar. This will open the Google Auth Platform dashboard.

If Auth Platform is already configured (the OAuth Overview page with usage metrics is displayed), skip this step and navigate to the Branding page from the sidebar. Otherwise, click the Get started button to begin the configuration process.

Fill in the required fields.

  • App name: Enter a name for your application (e.g., StackOne Integration).
  • User support email: Select an email for user inquiries.
  • Click Next to continue.
Google Auth Platform Branding page with App name and User support email fields

Choose the appropriate user type.

  • Internal: Only users within your Google Workspace organisation can authorise (no app verification required).
  • External: Any Google account can authorise (requires app verification for production use).
Google Auth Platform Audience page showing Publishing status, User type, and Test users sections

Enter email addresses where Google can notify you about changes to your project. Click Next to continue.

Review your settings, agree to the Google API Services User Data Policy, and click Create to finalise the setup.

Configure scopes

In the Google Auth Platform sidebar, navigate to Data Access and click Add or remove scopes to configure the OAuth scopes your application requires.

Enables actions: Create Custom Emoji, Create Member, Create Message, Create Reaction, Create Space, Delete Custom Emoji, Delete Member, Delete Message, Delete Reaction, Delete Space, Find Direct Message, Get Attachment, Get Current User, Get Custom Emoji, Get Member, Get Message, Get Space, Get Space Notification Setting, Get Space Read State, Get Thread Read State, List Custom Emojis, List Members, List Messages, List Reactions, List Spaces, Patch Member, Patch Message, Patch Space, Patch Space Notification Setting, Setup Space, Update Message, Update Space Read State

Add the required Google Chat scopes for your integration.

Google Auth Platform Data Access page with Add or remove scopes button and scope tables

In the Update selected scopes side panel that opens, check the required scopes from the list.

If a required scope does not appear in the list, use the Manually add scopes section.

  • Enter the full scope URL in the input field.
  • Click Add to table.

Confirm and save your scope configuration.

  • Click Update to apply the selected scopes. The side panel will close.
  • On the Data Access page, click Save to persist the scope configuration.

Create OAuth 2.0 client credentials

Set up OAuth client credentials to authenticate with the Google Chat API. If you already have an existing OAuth 2.0 client, you can reuse it by adding the StackOne redirect URI and generating a new secret.

In the Google Cloud Console, go to APIs & Services > Credentials.

APIs and Services Credentials page showing Create Credentials button and OAuth 2.0 Client IDs list

Skip this step if you are using an existing client.

  • Click + Create Credentials and select OAuth client ID.
  • Select Web application as the application type.
  • Enter a Name for your OAuth client (e.g., StackOne Chat Integration).
  • Under Authorized redirect URIs, click Add URI and enter `https://api.stackone.com/connect/oauth2/googlechat/callback`.
  • Click Create. A dialog will display your Client ID and Client Secret — copy and store them securely.
Create OAuth client ID and Client Secret

Skip this step if you created a new client above.

  • Click on your existing OAuth 2.0 client ID from the list.
  • Under Authorized redirect URIs, click Add URI, enter `https://api.stackone.com/connect/oauth2/googlechat/callback`, and click Save.
  • Under Client secrets, click + Add secret to generate a new secret. Copy and store it securely — it will not be displayed again.
  • Your Client ID is shown on the same page under Additional information.
Existing OAuth client ID page showing Add URI and Add secret buttons
## Creating the StackOne Connector Profile To create the Connector Profile in StackOne for Google Chat: Login to StackOne and navigate to [Connector Profiles](https://app.stackone.com/connector_profiles)
  • Click + Connector Profile
  • Search for and select Google Chat
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
 Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Google Chat.