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
- Step 1. Connect the integration
- Step 2. Configure the integration
- Step 3. Sync data
- Troubleshooting
- Google Workspace integration reference
Before you begin
To successfully set up the Google Workspace integration, you’ll need:
- A user with an admin role on Deel
- A user with an admin role on Google Workspace
- A user with a Google service account
We recommend checking our How To Create A Google Workspace Account For Direct Employees article.
We also recommend checking the Google Workspace integration reference to understand the features and limitations of the integration before starting to follow this guide.
Step 1. Connect the integration
In this section, we’ll guide you through how to connect Deel to Google Workspace.
To connect to Google Workspace:
1. Go to More > Apps and search for Google Workspace in the App Store.
2. On the integration page, click Connect Google Workspace.
3. Enter your Google Workspace admin email and upload your service account configuration file.
4. Click Connect & go to settings.
The integration is now connected, you can start to configure the integration.
Step 2. Configure the integration
In this section, we’ll guide you through configuring the integration so that data can sync successfully.
After connecting Google Workspace, configuring it consists of
Configure the field mapping plugin
This plugin allows users to easily select and sync specific fields between Deel and Google Workspace.
To configure the field mapping plugin:
1. From the Google Workspace integration page, go to the Plugins and settings tab.
2. Click Field Mapping.
3. Customize the user field mapping for Google Workspace.
The Field Mapping plugin is configured. Changes in employee data will be synced from Deel to Google Workspace.
Configure the user provisioning plugin
This plugin automatically creates Google Workspace accounts for new hires and suspends accounts upon termination.
To configure the user provisioning plugin:
1. From the Google Workspace integration page, go to the Plugins and settings tab.
2. Next to the User provisioning plugin, click Enable.
3. Choose the events you want to sync.
The User Provisioning Plugin is configured, new hires will be automatically provisioned in Google Workspace, and terminated accounts will be suspended.
Any HR fields that change on Deel will be synced. For instance, changes to a job title will be updated in Google Workspace after the next sync.
Step 3. Sync data manually
Automatic syncs occur daily, one way from Deel to Google Workspace, but you can manually trigger a sync:
- If you’ve made important changes and need them to sync immediately
- If you notice missing data or errors that suggest that the last sync didn’t complete correctly
To sync data, go to the Google Workspace integration page and click Sync Google Workspace.
Recent changes in employee data will be synced from Deel to Google Workspace.
Troubleshooting
This section includes instructions and workarounds to troubleshoot common issues.
Newly created Deel accounts without corresponding Google Workspace accounts won’t be matched.
Take note that this only happens when user provisioning is disabled. If user provisioning is enabled, a newly created Deel account, based on the rules set, should automatically get created in Google Workspace.
To solve this:
1. Go to People > Worker > Apps.
2. On the Apps page, select Google Workspace and click Create account.
3. On the Google Workspace account creation modal, select when to grant access.
The Google Workspace account is created and the username is displayed.
Google Workspace integration reference
This section provides information about the capabilities and limitations of the integration. You can use it to understand whether the integration can sync the data you need to sync.
Supported contract types
The Google Workspace integration supports the following contract types:
- Independent contractor
- Employer of record (EOR)
- Global payroll
- Professional employer organization (PEO)
Supported sync fields
The Google Workspace integration supports the sync of the following fields:
| Mapped from Deel | Description | Mapped by default? |
|---|---|---|
| Home Address | Worker’s residential address | No |
| Birth Date | Worker’s date of birth | No |
| Legal Entity Name | Legal name of the entity associated with the worker | Yes, to Cost Center |
| Worker Country | The country in which the worker is based | No |
| Department | The department the worker belongs to | Yes, to Department |
| Direct Manager Work Email | Email address of the worker's direct manager | No |
| Direct Report Work Email(s) | Email addresses of the worker’s direct reports. (A list of emails capped at 10) | No |
| Number of Direct Reports | The total count of direct reports under this worker | No |
| Personal Email | Worker’s email address | No |
| External Worker ID | Worker’s identity number assigned outside of Deel | No |
| Full Name | Worker’s full name | No |
| Worker Status | Current employment status of the worker | No |
| Worker Type | The classification of the worker | No |
| Job Title | Worker’s official job title | Yes, to Job Title |
| Nationalities |
The nationalities the worker holds. (Can be a list, if the worker has multiple nationalities) |
No |
| Preferred First Name | Worker’s preferred first name | No |
| Preferred Last Name | Worker’s preferred last name | No |
| Seniority | Worker’s level or seniority within the organization | No |
| Start Date | Worker’s start date at the company | No |
| Time zone | Worker’s local time zone | No |
| Worker ID | Worker’s identity number | No |
| First Name | Worker’s legal first name | Yes, and can’t be edited |
| Last Name | Worker’s legal last name | Yes, and can’t be edited |
| Work Email | Worker’s official work email | Yes, and can’t be edited |
| Username |
First part of the worker’s work email (before the @ symbol) |
No |
| Mapped from Deel | Description | Mapped by default? |
|---|---|---|
| Email (Home) | Worker’s personal email address | No |
| Email (Other) |
Additional email addresses (if any) |
No |
| Address (Home) | Worker’s home address | No |
| Address (Other) | Alternate address (if applicable) | Yes, to Home Address |
| Address (Work) | Worker’s work address | No |
| Recovery Email | Email for account recovery purposes | No |
| Employee ID | Worker’s identifier | No |
| Job title | Worker’s official job title | Yes, to Job Title |
| Type of employee | Worker’s type of employment | No |
| Manager’s email | Email address of the worker's manager | No |
| Department | The department the worker belongs to | Yes, to Department |
| Cost Center | Cost center linked to the worker | Yes, to Legal Client Entity |
| Building ID | Worker’s building identifier | No |
| Floor name | The floor name or number within the building | No |
| Floor section |
The specific floor location |
No |