Use a dedicated admin account to connect Google Workspace to Vanta, rather than a personal employee account. A dedicated account keeps the integration stable when people change roles or leave your company.
⚠️ Note: Despite the common name “service account,” this is a regular Google Workspace user, not a Google Cloud service account
When you connect, Vanta checks that the account can read users, groups, and admin roles. A super administrator has all of this access, so we recommend Option 1. If your security policy does not allow a dedicated super administrator, use Option 2.
Option 1 (recommended): Dedicated super administrator account
1. Create a new user
In the Google Admin console, select Directory, then Users.
Select Add new user.
Complete the required information. Select Add new user.
2. Assign the Super Admin role
From the Admin console, select Account followed by Admin roles.
Select the Super Admin role.
Select Assign admin.
Select Assign members, then choose the user you created in step 1.
Select Assign role.
3. Connect the account to Vanta
Sign in with this account when Google prompts you during the Vanta connection flow. For the full connection steps, see the Google Workspace: Integration Guide.
Option 2 (advanced): Limited admin account
Use this option only if you cannot use a super administrator. Vanta rejects the connection if any of the following is missing:
A custom admin role with Users > Read and Groups > Read. If you plan to enable vendor discovery ("Discover apps used with Google sign-in"), also add Security > User Security Management.
The Role Reader Admin and Role Assignment Reader Admin prebuilt roles. Google custom roles cannot include read access to admin roles, so these two prebuilt roles are required, and you need both. See Google's Prebuilt administrator roles documentation.
Every role assigned so that it covers your entire organization, not a single organizational unit.
1. Create a new user
Follow step 1 in Option 1.
2. Create the custom admin role
In the Google Admin console, select Account, then Admin roles.
Select Create new role, enter a name (for example, "Vanta Integration"), and select Continue.
Add the privileges listed above (Users > Read, Groups > Read, and optionally Security > User Security Management), then select Continue.
Select Create role.
3. Assign the roles
In the Google Admin console, go to Account, then Admin roles.
Select the custom role, select Assign admin, and add the new user.
Repeat for the Role Reader Admin prebuilt role.
Repeat for the Role Assignment Reader Admin prebuilt role.
Do not limit any of these roles to an organizational unit. Each role must cover your entire organization.
If a role is limited to an organizational unit, Vanta imports only part of your directory without showing an error.
4. Connect the account to Vanta
Sign in with this account when Google prompts you during the Vanta connection flow. For the full connection steps, see the Google Workspace: Integration Guide.
⚠️ Note: If this account later loses any of these privileges, the integration stops syncing. See the section below.
If the connecting account is suspended, deleted, or loses access
If the connecting account is suspended, deleted, or loses a privilege Vanta needs, the integration stops syncing. Today, adding the integration again for the same Google Workspace domain from the Vanta app does not work. Contact Vanta Support, who can move the connection to an active admin account while keeping your existing data.
