Skip to main content

Creating a Dedicated Admin Account for the Google Workspace Integration

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.

Screenshot 2025-03-17 at 4.58.37 PM.png
  • Select Add new user.

  • Complete the required information. Select Add new user.

Screenshot 2025-03-17 at 5.12.21 PM.png

2. Assign the Super Admin role

  • From the Admin console, select Account followed by Admin roles.

Screenshot 2025-03-17 at 5.03.11 PM.png
  • 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.

  • Every role assigned so that it covers your entire organization, not a single organizational unit.

1. Create a new user

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.