This article explains how clients using Deel HR can link their Google Workspace account (formerly G Suite) to Deel.
Clients can then easily create Google Workspace accounts for HR direct employees.
Google Workspace can provide a custom email for your business and include collaboration tools like Gmail, Calendar, Meet, Docs, Sheets, Slides, Sites, and more.
You can automatically invite your direct employees during the onboarding process!
In this article:
How to link your Google Workspace account
How to create a Google Workspace account for your employee
How to create your private key
How to link your Google Workspace account
✅ Step 1 – Open Google Workspace
Select the (1) Apps & Integrations tab on your home page, then click (2) Google Workspace
✅ Step 2 – Click Connect
✅ Step 3 – Authenticate your email address
Connect with Google Workspace by entering the admin email and your private key.
Please make sure that the admin email address you enter is a Google Workspace admin email, and not the email address linked to the service account.
Please review our tutorial on creating a private key and authorizing the Client ID.
Click Complete Setup.
✅ Step 4 – Personalize your Google Workspace settings
Select Apps & Integrations to see that the Google Workspace app is connected to your Deel account.
Click Manage, and then select the Settings tab.
From here you can personalize your Google Workspace settings:
- New user passwords: Manage how you provide the email password to your employees
- Email notification settings: Select where you want to receive communication
- Access time: Manage the provisioning policy for your employees
Create Google Workspace Account For Employee:
✅ Step 1 – Select the Add People tab to add the direct employee
Follow the prompts and add details about the employee, including job title, terms, agreement, and more.
✅ Step 2 – Add employee's current email
You will be asked in the 4th step to provide the current email of the employee.
Click Next.
✅ Step 3 – Create custom email address
Toggle on the option for Google Workspace.
Enter the new work email address for the employee and the domain.
You can then choose the provisioning policy: the employee's start date, or a scheduled creation date.
✅ Step 4 – Click Next
Review and confirm the employment agreement, and employee details.
Click Finish
How to create a Private Key
✅ Step 1 – Select Your Project
Follow this link to enter the Google Cloud Dashboard.
Select your project from the Deel API dropdown menu.
If you don't see your project, select New Project.
Fill in the project name, organization, and location, and then click Create.
✅ Step 2 – Create Service Account
Go to your Google Cloud dashboard.
Select the (1) Credentials tab, click (2) Create Credentials, and select (3) Service Account.
✅ Step 3 – Add Service Account details
Enter your service account name, and the account ID will be generated automatically.
Add a description of the service account.
Click Create and Continue
When asked to Grant This Service Access To Project, leave the role empty and click Continue.
When asked to Grant Users Access To This Service Account, leave all fields empty and click Done.
✅ Step 4 – Generate your Private Key
Select your newly created service account link
Select Add Key and then click Create new key
✅ Step 5 – Download and store private key
Select the JSON key type and click Create.
The private key will be saved to your computer.
Please make sure to store the key file securely.
✅ Step 6 – Enable the Admin SDK API
Go to your Google Cloud dashboard.
Select the (1) Enabled APIs & services tab and then select (2) ENABLE APIS ANS SERVICES
Search for Admin SDK API and click Enable
✅ Step 7 – Use your private key to copy Client ID
Go to your your Google Admin page.
Select the (1) Security tab, then the (2) Access and Data Control tab, and the (3) API controls.
Finally, click (4) Manage Domain Wide Delegation.
Add new, and open your private key file.
Copy the client_id from the code block.
✅ Step 8 – Copy scopes
Copy the following four scopes to OAuth scopes:
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.readonly
https://www.googleapis.com/auth/admin.directory.domain.readonly
✅ Step 9 – Authorize new client ID
After you entered the Client ID and copied the four OAuth scopes, click Authorize.
Frequently Asked Questions
[ACCORDION] How do I create a private key to authenticate my Google Workspace?
Please see our tutorial to create your private key and authorize the Client ID.
[ACCORDION] What Google Workspace settings can I manage and personalize for my employees?
New user passwords: Manage how you provide the email password to your employees
You can choose to generate a randomly-created password for new users, or create a custom password.
You can also select to make new users create a new password after the first successful login.
Email notification settings: Select where you want to receive communication
You can specify the email for notifications in case the integration loses authentication.
Click the Add button, and then enter a name and valid email address.
Access time: Manage the provisioning policy for your employees
Click Edit to personalize the provisioning policy for new employees.
You can choosethe start date, or select a personalized number of days before the start date.
Click Save Changes
[ACCORDION] How often will the integration sync?
The integration will sync every hour, at 40 minutes past the hour.
[ACCORDION] How can I disconnect the Google Workspace app?
✅ Step 1 – Select (1) Apps & Integrations from the home page, then click (2) Manage on the Google Workspace app
✅ Step 2 – Disconnect Google Workspace
Select More to open the options menu, then choose Disconnect Integration.
Click Yes, Disconnect to confirm.
