In order to set up Google Calendar integration in SmartRecruiters, you'll need to be an Administrator in SmartRecruiters, and have Administrator-level access to your company's Google Cloud Apps (console.developers.google.com) and Search Console (google.com/webmasters/tools).
Make sure to log into the Cloud Apps and Search Console and make changes using the same Gmail account.
- Configure Google Calendar to accept updates from SmartRecruiters.
- Configure SmartRecruiters to read Google Calendar and post updates.
When you enable a calendar integration, you give SmartRecruiters permissions to read and write ALL calendar data in your organisation. However, SmartRecruiters' integration pulls only a minimal subset of required data. Due to the technical limitations of Google's calendar services, we cannot limit or configure the scope of permissions allowed by the integration.
Configure Google Calendar
The first step in the configuration process allows SmartRecruiters to retrieve employees' Google Calendars.
- First, go to https://console.developers.google.com.
- Create a project if you don't already have one, or select an existing one.
Enable API access
Enable access to this project for the Calendar and Admin SDK APIs:
- In the API Manager pane, click Library to see the list of available APIs.
- In the Google Apps APIs list, click Calendar API, then Enable.
- Go back to the Library.
- In the Google Apps API list, click Admin SDK API, then Enable.
Now, you'll need to add create a service account and add credentials.
Create service account
Create a new service account:
- Back in the API Manager pane, click Credentials.
- Click Create Credentials.
Service account keyfrom the list.
New Service accountfrom the Service Account list.
- Name the service account
- For Role, select
- Make sure the JSON option is selected for Key Type.
- Click Create. The key will automatically download a .json file to your default download folder. Hold onto this file. You'll need this file later, and it is the only copy of the key.
Edit service account
Edit the service account:
- While still on the Credentials page, click Manage Service Accounts.
- Open the Options menu for the account you just created, and click Edit.
- Check Enable Google Apps Domain-wide Delegation.
- Enter SmartRecruiters Integration in the product name field.
- Click Save.
- After you’ve enabled Domain-wide Delegation, the API Manager will create an OAuth 2.0 Client ID. You’ll need this ID for the next step. To find it:
- In the API Manager pane, click Credentials.
- Find the client you just created by looking for the product name.
- Copy the Client ID.
Authorize Calendar API
Authorize the Calendar API client in your Google Admin settings:
- Go to https://admin.google.com.
- Navigate through Security > More Settings > Advanced settings > Manage API client access.
- Enter the Client ID into the Client Name field.
- In the One or More API Scopes field, enter both of the following URLs and separate them with a comma:
- Click Security to go back to the Security Admin page.
- If it’s not already selected, click Enable API access.
The second step in the setup process allows Google to recognize changes to an employee's calendar (e.g., when they Accept or Decline an interview) and updated SmartRecruiters.
- Log in to SmartRecruiters and go to the Settings / Admin page.
- Click Calendar Integrations, then the Google Integration tab.
- Under Key File, click Choose a file and upload the .json key file you downloaded earlier.
- Click Copy to copy the Google Calendar Webhook URL for your SmartRecruiters account. It’ll look similar to:
- Open https://www.google.com/webmasters/tools.
- Paste the Google Calendar Webhook URL. Make sure to include the
- Click Add A Property.
- In the Search Console verification page, download the HTML verification file. Keep this page open.
- Back in SmartRecruiters, on the Google Integration page, upload the HTML file into the Verification File field. Make sure that the file name is identical to the one that you downloaded.
- On the Google Search Console page, then complete the CAPTCHA and click Verify.
- Go to https://console.developers.google.co...inverification. Make sure you’re in the project that contains your Google Calendar service account.
- Paste the Google Calendar Webhook URL without the
- Click Add Domain.
- In SmartRecruiters, on the Google Integration tab, click Load Resources to add any reservable calendar resources, such as conference rooms.
SmartRecruiters may take a few minutes to refresh and complete the integration, so if you see an error message that SmartRecruiters “can’t load resources”, just wait a few minutes.
When your calendar resources have loaded into the list, contact SmartRecruiters Support to finish the integration.