Skip to main content

Google Workspace Integration

Automatically sync employee data from Shapes to Google Workspace.

Written by Efrat Barak Zadok

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

  • Lifecycle management: the integration handles creating new users, updating existing profiles, and suspending employees as needed

Data synced

The integration can sync:

  • First name

  • Last name

  • Email

  • Job title

  • Department

  • Manager

  • 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

  1. Go to Google Cloud Console

  2. Navigate to APIs & Services:

    Google Cloud Console APIs & Services navigation menu

  3. Open Library

  4. Search for Admin SDK API

  5. Click Enable

Google Cloud Console API Library showing Admin SDK API search result

2. Create a service account

  1. Go to APIs & Services → Credentials

    Google Cloud Console Credentials page

  2. Click Create Credentials → Service Account

    Create Credentials menu with Service Account option selected

  3. Enter a name for the service account

    Service account creation form with name field

  4. Click Done (skip optional fields)

3. Generate a JSON key

  1. Open the service account you created

  2. Go to the Keys tab

  3. Click Add Key → Create new key

    Add Key menu with Create new key option

  4. Select JSON

  5. Download the file

Key type selection dialog with JSON option

👉 You'll upload this file to Shapes later.

4. Copy the Client ID

  1. Open the service account details

  2. Copy the Client ID (Unique ID)

Service account details page showing Client ID field

5. Configure domain-wide delegation

  1. Go to Google Workspace Admin Console (https://admin.google.com/) and log in with a super admin

  2. Navigate to:
    ​Security → Access and Data Control → API Controls

    Google Workspace Admin Console API Controls navigation path

  3. Click Manage Domain Wide Delegation

  4. Click Add new

    Domain Wide Delegation management page

  5. Enter:

    Add new API client form with Client ID and OAuth scope fields

  6. Click Authorize

6. Connect in Shapes

  1. Go to Account Settings → Integrations → Google Workspace

  2. Upload the JSON key file

  3. Enter a Google Workspace admin email

    • Must be a Super Admin or have Directory API access

  4. 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, or want to customize field mapping or apply specific sync filters, contact Shapes Support.

Did this answer your question?