Skip to main content
Super Admin or Admin privileges in Google Workspace are required to complete this setup. The account that authorizes the connection needs the Super Admin role or a delegated admin role.

Create a Google Cloud OAuth client

Set up a Google Cloud project with the Admin SDK API enabled and an OAuth client for StackOne.

1

Create or select a project

Sign in to your Google Cloud Console, then open the project picker at the top of the page.

  • New project: Click New project, fill in Project name, Organization and Parent resource, then click Create. Select the new project in the project picker.
  • Existing project: Select it in the project picker.
2

Enable the Admin SDK API

Open APIs & Services > Library.

  • Search for Admin SDK API.
  • Click Admin SDK API.
  • Click Enable. If it shows Manage, it’s already enabled.
3

Enter the app information

Open APIs & Services > OAuth consent screen to open the Google Auth Platform dashboard.

  • Click Get started. If the OAuth Overview page opens instead, open Branding from the sidebar.
  • App name: A name that identifies this integration
  • User support email: Email address for user inquiries
  • Click Next.
4

Select the audience

Choose the user type for your application.

  • Internal: Only users within your Google Workspace organization can authorize (no app verification required)
  • External: Any Google account can authorize (requires app verification for production use)
  • Click Next.
5

Enter contact information

Google sends notices about changes to your project to these addresses. If you opened Branding, the field is under Developer contact information on the same page.

  • Email addresses: Email addresses for project notices
  • Click Next.
6

Accept the user data policy

Review your settings.

  • Agree to the Google API Services User Data Policy.
  • Click Create.
7

Add the scopes

Enables actions: Add Member To Group, Check Member Existence, Create Domain, Create Group, Create Organizational Unit, Create User, Delete Domain, Delete Group, Delete Organizational Unit, Delete User, Get Domain, Get Group, Get Member, Get Organizational Unit, Get Unified Group, Get Unified Organization, Get Unified Role, Get Unified User, Get User, List Domains, List Groups, List Members, List Organizational Units, List Unified Groups, List Unified Organizations, List Unified Resource Types, List Unified Resource Users, List Unified Roles, List Unified Users, List Users, Patch Group, Patch Member, Patch Organizational Unit, Patch User, Remove Member From Group, Update Group, Update Member, Update Organizational Unit, Update User

If using the following actions then add these additional scopes as well as the ones below:

List Unified Users and Get Unified User: https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly enables them to return the roles a user holds through group membership.

Get Unified Credentials: https://www.googleapis.com/auth/userinfo.email enables it to return the email and name of the account that authorized the connection.

  • In Google Auth Platform, open Data Access.
  • Click Add or Remove Scopes.
  • Under Manually add scopes in the Update selected scopes side panel, paste each scope listed and the optional scopes.
  • Click Add to table.
  • Click Update.
  • On the Data Access page, click Save.
8

Create the OAuth client

Open APIs & Services > Credentials.

  • Click Create credentials.
  • Select OAuth client ID.
  • Application type: Web application
  • Name: A name that identifies this integration
  • Under Authorized redirect URIs, click Add URI.
  • Enter the Callback URL from your Connector Profile.
  • Click Create.
9

Copy the Client ID and Client Secret

A dialog shows your Client ID and Client Secret.

  • Copy the Client ID and Client Secret into your Connector Profile.

Create the StackOne Connector Profile

1

Create a Connector Profile

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.
2

Link an Account

Once the Connector Profile is created, continue to link an account.