Google Workspace — team member import

Import team members from your Google Workspace directory into Swopi. One-click connect via Google sign-in (Workspace admin only), read-only. Imports name, email, job title, department and photo; the business card is created automatically.

The integration with Google Workspace imports your team members straight from your corporate Google directory into Swopi. A new employee in the directory = a ready account in Swopi with a business card; a job-title change in the directory = up-to-date details on the card. Set it up once by signing in with Google, and it runs without manual entry.

This is a member import (not CRM lead-sync). Swopi reads your Google Workspace directory (Admin SDK Directory API, read-only), one-way, and never deletes anything. The connection is native OAuth — sign in with Google and allow access, no API keys to paste. The connecting account must be a Google Workspace administrator — the scope used is admin-restricted.

#Overview
Data source Google Workspace directory (Admin SDK Directory API)
Connection Native OAuth (Google sign-in)
Scope admin.directory.user.readonly — read-only user access
Direction Google Workspace → Swopi (one-way import)
What's imported Name, email, job title, department, phone, profile photo
Trigger Manual "Sync members"
Who connects Google Workspace administrator
Availability Swopi Teams plan, configured by the organization administrator

#Prerequisites

  • a Google Workspace administrator account (sign-in is refused without admin rights),
  • the administrator role in Swopi and the Swopi Teams plan.

#How to connect

Dashboard → Integrations → Team member import → Google Workspace:

  1. Click Connect Google Workspace.
  2. Sign in with a Google Workspace admin account and allow access.
  3. You return to the configuration — the integration is connected.

#Importing members

Once connected, click Sync members. Swopi walks through your Google Workspace directory and:

  • creates a new member (an account signing in with Google + a ready business card),
  • updates an existing member's name, job title, department and phone,
  • skips suspended accounts,
  • safely skips accounts belonging to another organization (never takes them over).

When it finishes you'll see the number of new and updated members and the time of the last sync.

#What gets imported

Google Workspace field Swopi
name.fullName (given + family name) Name
primaryEmail Email (sign-in identity)
organizations[0].title Job title
organizations[0].department Department / company
phones[0].value Phone
thumbnailPhotoUrl Profile photo

#How it works

  • A new member gets an account — the business card is created right away (name, email, job title from the directory), signing in with their corporate Google account (SSO).
  • The import is one-way and read-only — Swopi changes nothing in Google Workspace.
  • The import does not delete members — removing someone from the directory does not remove the member in Swopi.

#Troubleshooting

Symptom Fix
"Account is not a Google Workspace administrator" Sign in with an account that has admin rights in Google Workspace.
"Access wasn't granted" Sign in with Google again and allow access.
Sync failed Verify that Admin SDK API is enabled in Google Cloud and the connection is active.
"Connection pending activation" The one-time Swopi setup hasn't finished yet (activates shortly after deploy).

#Disconnecting

In Integrations → Google Workspace click Disconnect — the connection is removed and the import stops. Members and cards created by an earlier import stay.

Integration contact: support@swopi.co