What this integration does
The Google Workspace integration allows you to:
Automatically sync employee data from Shapes to Google Workspace
Keep employee profiles up to date
Manage users centrally from Shapes
How the integration works
Data syncs once per day
Sync direction: Shapes → Google Workspace
Employee fields are automatically updated in Google Workspace
Data synced
The integration can sync:
First name
Last name
Email
Phone number
Additional employee fields (configurable)
What you'll need
Admin access to your Google Workspace account
Access to Google Cloud Console
Admin permissions in Shapes
Ability to create service accounts and configure domain-wide delegation
1. Enable Admin SDK API
Go to Google Cloud Console
Navigate to APIs & Services:
Open Library
Search for Admin SDK API
5. Click Enable
2. Create a service account
Go to APIs & Services → Credentials
Click Create Credentials → Service Account
Enter a name for the service account
Click Done (skip optional fields)
3. Generate a JSON key
Open the service account you created
Go to the Keys tab
Click Add Key → Create new key
Select JSON
5. Download the file
👉 You’ll upload this file to Shapes later.
4. Copy the Client ID
Open the service account details
Copy the Client ID (Unique ID)
5. Configure domain-wide delegation
Go to Google Workspace Admin Console (https://admin.google.com/) and log in with a super admin
Navigate to:
Security → Access and Data Control → API Controls
Click Manage Domain Wide Delegation
4. Click Add new
Enter:
Client ID → unique ID copied earlier (step 4)
OAuth Scope → https://www.googleapis.com/auth/admin.directory.user
https://www.googleapis.com/auth/admin.directory.user
Click Authorize
6. Connect in Shapes
Go to Account Settings → Integrations → Google Workspace
Upload the JSON key file
Enter a Google Workspace admin email
Must be a Super Admin or have Directory API access
Click Connect
Troubleshooting
If the integration isn’t working:
Ensure Admin SDK API is enabled
Verify domain-wide delegation is configured correctly
Confirm the OAuth scope is correct
Make sure the admin email has sufficient permissions
Check that the JSON file matches the service account
Need help?
If you need help setting up or troubleshooting the integration, contact Shapes Support.