How to connect Google Workspace to Deel

Deel can connect to and sync data with Google Workspace using the dedicated integration. 

This article explains how to configure Deel and Google Workspace so that you can sync data between them.

In this article

Here’s what you’ll find in this article:

• Before you begin
• Setting up credentials
  • Step 1: Enable the Admin SDK API
  • Step 2: Create the service account and key
  • Step 3: Authorize domain-wide delegation
• Connecting Google Workspace to Deel
  • Step 4: Connecting the integration
• Managing employee accounts
  • Step 5: Automatic provisioning
  • Optional: Manual account creation
• Configuring other plugins
  • Step 6: Setting up field mapping
  • Step 7: Syncing Dynamic Groups
• Syncing Data
  • Step 8: Triggering manual sync
• Next Steps

Before you begin

You must have:

• A Deel account and be logged in.
• Deel Organization Admin access.
• Super Admin access to the Google Admin Console.
• (Recommended) Read the Google Workspace integration Overview to understand the features and limitations of the integration before following this guide.

Setting up credentials

Before connecting Deel, you must create a secure bridge in the Google Cloud Console.

Step 1: Enable the Admin SDK API

1. Go to the Google Cloud Dashboard.
2. Create a new project named "Deel Integration".
3. Go to APIs & Services > Enabled APIs & Services.
4. Click + Enable APIs and Services, search for Admin SDK API, and click Enable.

Step 2: Create the service account and key

1. In the Cloud Console, go to IAM & Admin > Service Accounts.
2. Click Create Service Account. Name it "Deel-Provisioning" and click Create and Continue.
3. Grant Access: Leave the roles empty (click Continue) and skip user access (click Done).
4. Click on the newly created Service Account email, go to the Keys tab, and select Add Key > Create New Key.
5. Select JSON and click Create. The file will download automatically—store this securely, as it contains the credentials for your domain.

Step 3: Authorize domain-wide delegation

1. Open the JSON file you just downloaded and copy the client_id (a long string of numbers).
2. Go to the Google Admin Console and navigate to Security > Access and Data Control > API Controls.
3. Click Manage Domain Wide Delegation and then Add New.
4. Paste the Client ID and copy/paste the following scopes into the OAuth Scopes field:

https://www.googleapis.com/auth/admin.directory.user, 
https://www.googleapis.com/auth/admin.directory.userschema.readonly, 
https://www.googleapis.com/auth/admin.directory.group, 
https://www.googleapis.com/auth/admin.directory.group.member, 
https://www.googleapis.com/auth/admin.directory.group.readonly, 
https://www.googleapis.com/auth/admin.directory.domain.readonly

5. Click Authorize.

Connecting Google Workspace to Deel

Once Google Workspace is configured to interact with Deel, you can connect the platforms. 

Step 4: Connecting the integration

1. In Deel, go to Hub > Apps and select Google Workspace.
2. Click Connect Google Workspace.
3. Enter the following information
   • Your Google super admin email address.
   • Upload the JSON Private Key you generated in Part 1.
4. Click Connect & Go to Settings.

Managing employee accounts

You can now manage accounts either automatically or manually.

Step 5: Automatic provisioning (Recommended)

Enable the User Provisioning Plugin in the settings tab. Deel will automatically create Google Workspace accounts for new hires based on your contract workflows. Data sync is continuous.

Optional: Manual account creation 

If you need to create an account for an employee outside of the automated workflow:

1. Go to People > All People and select the worker.
2. Go to the Apps tab within their profile.
3. Click Create Account on the Google Workspace row.
4. Enter the desired work email and click Complete. The credentials will be sent to the employee's personal email immediately.

Configuring other plugins

Once connected, you must define how data flows between the two systems using specific plugins.

Step 6: Setting up field mapping 

The field mapping plugin ensures that worker details in Deel (such as Job Title or Department) match the fields in Google Workspace.

1. Click Field Mapping in the Plugins tab.
2. Review default mappings (First Name, Last Name, and Work Email are required and non-editable).
3. Map optional fields like Cost Center or Direct Manager to ensure your Google Directory stays updated automatically.

Step 7: Syncing Dynamic Groups  

Use this to manage Google Groups (mailing lists) based on Deel's organizational structure.

1. Click Dynamic Groups Syncing and select Create Dynamic Group.
2. Define rules (e.g., "All employees in the Marketing department").
3. Assign a unique group email address.
4. Click Add and Sync to mirror these groups in your Google Admin console.

Syncing Data

Data flows continuously and in one way: from Deel to Google Workspace. A daily sync is also performed at midnight.

Step 8: Triggering manual sync

If you need an update to reflect immediately, you can follow the steps below.

1. Go to the Google Workspace integration page in Deel.
2. Click Sync Google Workspace.

Next Steps

• Learn more about the integration's capabilities and limitations in the Google Workspace Integration Overview.
• Find solutions to common issues in the Google Workspace Integration Troubleshooting guide.