Connecting Google Workspace to ATS for interview scheduling

Connect your organization's Google Workspace to ATS so hiring members can schedule interviews on their Google Calendars. You create a service account in your own Google Cloud project, allow it to access calendars in your domain through domain-wide delegation, and upload its key to ATS.

To send and receive candidate emails through Gmail, see Connecting Google Workspace to ATS for email integration. That's a separate setup.

In this article

• Before you begin
• Step 1. Create a Google Cloud project and enable the Google Calendar API
• Step 2. Create a service account and download its key
• Step 3. Authorize domain-wide delegation in the Google Admin console
• Step 4. Connect Google Workspace in ATS
• Disconnecting Google Workspace
• Troubleshooting

Before you begin

In Google

• Your organization uses Google Workspace with Google Calendar.
• You can sign in to the Google Admin console as a super admin. Only super admins can authorize domain-wide delegation.
• You can create projects, service accounts, and service account keys in the Google Cloud console.

In Deel

• You're allowed to manage ATS settings.
• Your own Work email in your People profile is on your organization's email domain and belongs to an active Google Workspace account. ATS uses it to check the connection.
• Every interviewer has their company email in the Work email field of their People profile. ATS uses this address to reach their Google Calendar.

Step 1. Create a Google Cloud project and enable the Google Calendar API

1. Sign in to the Google Cloud console with an account in your Google Workspace organization.
2. Open the project selector at the top of the page and click New project.

3. Enter a Project name, select your Organization and Location, and click Create.
4. Make sure the new project is selected in the project selector.
5. Go to APIs & Services > Library.
6. Search for Google Calendar API and open it.

7. Click Enable.

You can use an existing project instead, as long as the Google Calendar API is enabled in it.

Step 2. Create a service account and download its key

1. In the same project, go to IAM & Admin > Service accounts.
2. Click Create service account.
3. Enter a name and description, and click Create and continue.
4. Skip the optional permission steps and click Done.
5. In the list of service accounts, click the new account's email address to open it.
6. On the Details tab, copy the Unique ID. This is the service account's client ID. You'll need it in Step 3. The same number appears as Client ID under Advanced settings > Domain-wide delegation further down the tab.

7. Open the Keys tab and click Add key > Create new key.

8. Select JSON and click Create. The JSON key file downloads to your computer.

If Google says that service account key creation is disabled, see Troubleshooting.

Step 3. Authorize domain-wide delegation in the Google Admin console

1. Sign in to the Google Admin console with your super admin account.
2. Go to Security > Access and data control > API controls. If you don't see Security, open the menu first.

3. Under Domain-wide delegation, click Manage Domain Wide Delegation.
4. Click Add new.

5. Enter the following:
   • Client ID: the Unique ID you copied in Step 2
   • OAuth scopes: https://www.googleapis.com/auth/calendar
6. Click Authorize.

This scope lets ATS read and update the calendars of hiring members in your domain, so it can find free time and add interviews.

Google can take some time to apply the change. If ATS says the service account isn't authorized when you connect, wait a few minutes and try again.

Step 4. Connect Google Workspace in ATS

1. In the Deel sidebar, select Recruitment, then ATS.
2. Select Settings in the top navigation.
3. Under Interviews and scheduling, select Interview settings.
4. Check the Email domain field at the top of the page. If it shows No email, click the edit icon, enter your organization's email domain (for example, company.com), and click Submit.

5. Next to Google Workspace, click Connect.
6. Under Configuration file, upload the JSON key file from Step 2, exactly as you downloaded it.

7. Click Submit.

When the connection succeeds, Google Workspace shows as Connected, and hiring members can schedule interviews with candidates.

ATS connects one calendar provider at a time. If Microsoft Azure is already connected for interview scheduling, Connect stays disabled until you disconnect it.

Disconnecting Google Workspace

1. In ATS, go to Settings > Interview settings.
2. Next to Google Workspace, click Disconnect and confirm.

Hiring members can no longer schedule interviews, and scheduled interviews are removed.

To revoke access in Google too, delete the client ID under Manage Domain Wide Delegation in the Google Admin console, and delete the service account key in the Google Cloud console.

Troubleshooting