Google Workspace

Connect Empuls to Google Workspace to sync your employee directory and post recognition, milestones, and notifications into Google Chat.

The Google Workspace integration links your Empuls instance to your Google domain so that two things happen automatically. First, Empuls reads your Google Workspace directory to keep employee records aligned — you don’t have to maintain the same user list in two places. Second, an Empuls app installs into your Google Workspace Marketplace so recognition, milestones, and notifications can appear in Google Chat spaces and direct messages.

To open the integration, navigate to Admin Hub → Integrations → Google Workspace.

This is a directory + Google Chat integration. To use Google as a sign-in method instead, see Google Workspace SSO.

Before you start

• You must be a Super Admin in Empuls.
• You must be a Google Workspace super administrator (or have permission to authorize third-party apps and install Marketplace apps for your domain).
• Your Google Workspace domain must match the company email domain configured in Empuls.

How the integration works

1. OAuth consent

   Empuls opens a Google sign-in screen and asks for permission to read your Workspace directory.

2. Directory preview

   Once OAuth completes, Empuls fetches a preview of your domain’s user list so you can confirm you’re connected to the right domain before going further.

3. Connect code

   Empuls generates a one-time connect code. You’ll use it during the Google Workspace Marketplace install to bind the Empuls Chat app to your Empuls tenant.

4. Marketplace install

   A Google Workspace admin installs the Empuls app from the Marketplace and pastes the connect code. Status flips to Installed.

5. Fully connected

   Both integration status and marketplace status read as connected. Empuls now syncs the directory in the background and Empuls notifications appear in Google Chat.

The page polls every 12 seconds during connection to refresh both statuses, so you can watch the progress without manually reloading.

Connect Google Workspace

1. Open the integration

   From the Admin Hub, navigate to Integrations and click Google Workspace.

2. Click Start Integration

   A Google OAuth consent screen opens. Sign in with a Google Workspace super-admin account and approve the requested scopes (read your domain’s directory).

3. Verify the directory preview

   After OAuth completes, Empuls shows a snapshot of your domain — domain name and a sample of user records — so you can confirm you’re connected to the right Workspace tenant.

4. Reveal and copy the connect code

   Empuls displays a one-time connect code (masked by default). Click the eye icon to reveal it, then the copy icon to copy it. Keep this code somewhere safe — you need it for the next step.

5. Install the Empuls app from the Google Workspace Marketplace

   In a new tab, open the Google Workspace Marketplace listing for Empuls and click Install. Approve the install for your domain. During install, paste the connect code from the previous step to bind the Marketplace app to your Empuls tenant.

6. Wait for the page to update

   Return to the Empuls integration page. Within a few polls (~12 seconds each), the marketplace status flips to Installed and the integration is fully connected.

What gets synced

Once connected, Empuls reads the following from Google Workspace on a recurring schedule:

Data	What Empuls does with it
Active users	Adds new users to Empuls; updates email, name, and basic profile fields.
Organization unit	Maps to Empuls department where you’ve set up the mapping.
Manager relationship	Updates the reporting manager on the Empuls employee record.
Deactivated users	Marks users inactive in Empuls following your employee exit policy.

Field mapping for non-standard attributes can be configured during integration setup.

Empuls in Google Chat

After the Marketplace install:

• Recognition — Recognition awards posted in Empuls can appear in a designated Google Chat space or as a direct message to the recipient.
• Milestones — Birthdays, work anniversaries, and onboarding events surface in the Chat space you choose.
• Notifications — Survey invitations, redemption confirmations, and approval requests can be delivered as Chat messages.
• Slash commands — Employees can give recognition from Chat using the Empuls slash command, mirroring the Slack integration experience.

Pick a high-visibility Chat space for recognition (for example, #kudos or #all-hands) so awards reach a wide audience. Direct-message notifications stay private to the recipient.

Reconnect or disconnect

If you need to refresh the OAuth scopes (for example after a Google admin policy change) or fully disconnect:

1. Open the integration

   Navigate to Admin Hub → Integrations → Google Workspace.

2. Open the action menu

   Click the action menu in the top-right of the integration page.

3. Choose Reconnect or Disconnect

   Reconnect re-runs the OAuth flow and regenerates the connect code. Disconnect revokes OAuth and stops directory sync; Marketplace install must be removed separately from your Google Workspace admin console.

Disconnecting Google Workspace stops directory sync, but does not deactivate existing Empuls users. To clean up users imported via Workspace, run an HRMS-style bulk update in Empuls.

Limits and gotchas

• Connect code is single-use. If the Marketplace install fails, regenerate a new code from the integration page; old codes don’t work twice.
• OAuth scopes are domain-wide. Connecting Empuls to one Workspace OU and a separate OU at the same domain isn’t supported — it’s one Workspace ↔ one Empuls tenant.
• Initial sync may take several minutes for large domains. The directory preview shows the first page only; full sync runs in the background.
• The integration uses bearer-token JWTs from accounts.google.com and the Google Chat service account to verify Chat webhooks. If your network blocks Google’s OAuth2 cert endpoint, Chat webhook verification fails.

Related

• Google Workspace SSO — Sign in to Empuls using Google as the identity provider.
• Slack integration — Equivalent setup for Slack workspaces.
• HRMS integration — For directory sync from an HR system of record instead of Google.