> ## Documentation Index
> Fetch the complete documentation index at: https://wavecnct.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Workspace

> Keep your Wave team directory in sync with Google Workspace

<Info>
  Available on the **Teams** and **Enterprise** plans. This is an organization-level integration, configured by an admin.
</Info>

The Google Workspace integration keeps your Wave team directory in sync with your Google Workspace directory. When an employee is added, updated, or removed in Google Workspace, Wave reflects those changes automatically, with no manual user management required.

## How to Connect

<Steps>
  <Step title="Open the integration">
    Go to **Integrations → Google Workspace** (admin only).
  </Step>

  <Step title="Connect with an admin account">
    Click **Connect** and sign in with a Google Workspace admin account.
  </Step>

  <Step title="Authorize Wave">
    Authorize Wave to read your directory.
  </Step>

  <Step title="Enable auto-sync">
    Turn on **Auto-sync** to apply all future directory changes to Wave automatically, or manage syncs manually.
  </Step>
</Steps>

Wave requests read-only access to read users from your Google Workspace directory.

## What Gets Synced

| Google Workspace field        | Wave user field |
| ----------------------------- | --------------- |
| First name, last name         | Name            |
| Primary email                 | Email           |
| Work phone                    | Work phone      |
| Mobile phone                  | Mobile phone    |
| Job title (from organization) | Job title       |
| City (from address)           | City            |
| Language preference           | Language        |

**Sync direction**: Google Workspace → Wave (inbound only)

**When**: Real-time via Google Workspace webhooks, plus on-demand manual refresh

## Features

* **Real-time sync**: employee changes in Google Workspace (new hires, role changes, departures) are reflected in Wave within minutes via webhooks.
* **Auto-deactivation**: when an employee is archived or suspended in Google Workspace, their Wave account is automatically deactivated.
* **Import preview**: view all Workspace users before enabling auto-sync.

## Limitations & Requirements

* Requires a Google Workspace admin account to authorize.
* Profile photos that require a Google login to view are not imported.
* This is an organization-level integration. Individual team members do not connect separately.

## Disconnecting

Go to **Integrations → Google Workspace** and click **Disconnect**. This removes the integration, revokes Wave's access, and unregisters the webhook subscription. Existing Wave users are not deleted.