Overview
This guide will walk you through the steps generate your client credentials within Google Workspace and input them into Merge. Note that partnership is not required for the Google Workspace integration to work.
Instructions
Step 1: Generate OAuth credentials in Google
Create a Google Cloud Project here!
In your Dashboard, go to APIs & Services, and click on Credentials.
Create a Project for the partnership configuration!
Configure your OAuth Consent Screen with User Type: External and Published.
Click +Create Credentials and begin steps to create an OAuth Client ID.
Mark the Application type as Web Application.
Add the Merge Redirect URI as https://app.merge.dev/oauth/callback.
Click CREATE. You will see a screen that shows the OAuth Client ID and Secret for your account.
Step 2: Add your Google Workspace client credentials to Merge
On the Merge Dashboard, navigate to the Integrations tab.
Under HRIS, identify the Google Workspace integration.
Enable the integration using the toggle on the right.
Click Edit.
Select My Credentials.
Enter the following information in the corresponding fields
OAuth Client Id: OAuth Client ID
OAuth Client Secret: OAuth Secret
OAuth Redirect URI: https://app.merge.dev/oauth/callback
Notes:
Please confirm that the Admin SDK API is enabled. This can be found in APIs & Services --> Enabled APIs & Services
In your Google Admin account (admin.google.com),
Go to API Access Control and the Settings section,
Ensure the "(Default) Allow users to access any third-party apps" option is selected.
From there you should see the Merge app show up under the "Accessed Apps" list.
Please confirm you have Admin access
Please confirm your OAuth Consent Screen is "Published" and "External" user type
The standard scopes that you should set on the Google Workspace side are the following:
If you'd like Read-only scopes, you can use these but you will have to reach out to our team to notify us that you've opted for the non-standard scopes: