N
Interview GPS helps you win the war for talent by running more effective phone screens and face-to-face interviews. Spend more time selling your roles, while avoiding hiring mistakes.
Greenhouse Recruiting's integration with Interview GPS enables your team to:
- Build institutional knowledge by collaborating on re-usable question guides and rubrics
- Save time by linking question guides to your Greenhouse Recruiting interview plans
- Make every interview count with insights/recommendations based on the data your interviewers are already capturing
In this article, we will cover:
- Configure User Setup Permissions in Greenhouse Recruiting
- Create a Harvest API Key for the Greenhouse Recruiting / Interview GPS Integration
- Provide Harvest API Key to Interview GPS
- Create the Interview GPS Web Hooks (Optional)
- Configure Job and User Syncing Between Greenhouse Recruiting and Interview GPS
- Install the Interview GPS Chrome Extension
- Edit and Import Job Scorecards
- Edit and Import Interview Plans
- View Candidate Application Recommendations
- Get Help
Configure User Setup Permissions in Greenhouse Recruiting
In order to enable the Greenhouse Recruiting / Interview GPS integration, you will need the developer permission Can manage ALL organization’s API Credentials. If your organization intends to configure web hooks as part of the integration, you also will need the developer permission Can manage and configure web hooks.
Contact a Greenhouse Recruiting user in your organization with Site Admin level permissions with the additional user-specific permission Can edit another user's advanced permissions to apply the API credential management permission (and the web hook permission if appropriate) to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon > Users > Your Name.
The user with Site Admin level permissions should navigate to the Permissions panel on your user page and expand the Developer Permissions dropdown menu.
Select Can manage ALL organization’s API Credentials so that a check is in the checkbox. If appropriate, select Can manage and configure web hooks as well. When finished, click Save.
Repeat as necessary for any other user that should have access to set up the integration.
Create a Harvest API Key for the Greenhouse Recruiting / Interview GPS Integration
To create a Harvest API key for the integration, click on the Configure icon in the upper right-hand corner. Navigate to Dev Center on the left-hand panel.
From the Dev Center page, click API Credential Management.
From the API Credential Management page, click Create New API Key to generate the API key for Interview GPS.
From the Create new credential dialog box, give your API key a name and select Harvest from the Type dropdown menu. When finished, click Create.
On the Manage API Key Permissions page, grant the API key the permissions listed below. When finished, click Update.
Applications:
|
![]() |
Candidates:
|
![]() |
Close Reasons:
|
![]() |
Job Stages:
|
![]() |
Jobs:
|
![]() |
Offers:
|
![]() |
Rejection Reasons:
|
![]() |
Scheduled Interviews:
|
![]() |
Scorecards:
|
![]() |
User Roles:
|
![]() |
Users:
|
![]() |
Your Harvest API key for the Greenhouse Recruiting / Interview GPS integration is created and configured. Copy and save the Harvest API key to provide to Interview GPS in the next step.
Provide Harvest API Key to Interview GPS
With your Harvest API key copied, log into Interview GPS using the same email address that is your primary email address in Greenhouse Recruiting. Navigate to the Settings page in Interview GPS.
In the Greenhouse Integration section, enter the following information:
- Hostname: The start of the URL you use to access Greenhouse Recruiting (e.g. https://app.greenhouse.io or https://app2.greenhouse.io)
- Harvest API Key: The Harvest API key you created in the previous step
Click Set Token at the bottom of the section when finished.
Create the Interview GPS Web Hooks (Optional)
If your team wishes to configure the Interview GPS web hook as part of the integration, you will need to retrieve two pieces of information from the Greenhouse Integration section on the Interview GPS Settings page:
- Hook Secret
- Callback URL
Once you have copied and saved this information, return to Greenhouse Recruiting and click the Configure icon in the upper right-hand corner. Navigate to Dev Center on the left-hand panel.
From the Dev Center page, click Web Hooks. Click Web Hooks from the subsequent page.
You will be directed to the Create A New Web Hook page. From this page provide the following details:
- Name: We suggest Interview GPS: Application Updated
- When: Be sure to select the right action so the web hook fires at the appropriate event in Greenhouse Recruiting. [Application Updated]
- Endpoint URL: The Callback URL from the Interview GPS Settings page
- Secret Key: The Hook Secret from the Interview GPS Settings page
When finished, click Create Web hook at the bottom of the page.
Repeat the steps above to create a second web hook using the following details:
- Name: We suggest Interview GPS: Job Updated
- When: Be sure to select the right action so the web hook fires at the appropriate event in Greenhouse Recruiting. [Job Updated]
- Endpoint URL: The Callback URL from the Interview GPS Settings page
- Secret Key: The Hook Secret from the Interview GPS Settings page
When finished, click Create Web hook at the bottom of the page.
Configure Job and User Syncing Between Greenhouse Recruiting and Interview GPS
Once you have provided the Harvest API key to Interview GPS, and created the web hooks (if appropriate), you will perform the initial user import to Interview GPS and select which jobs to sync.
Return to the Interview GPS platform and navigate to the Settings page. From the Settings page, click Open Sync Settings.
On the Greenhouse Sync Settings page, perform the following actions:
- Click Import Users and Permissions
- Click the Sync toggle from Off to On for any jobs you wish to analyze with Interview GPS
Install the Interview GPS Chrome Extension
The Interview GPS Google Chrome extension shows information about roles and candidates from Interview GPS directly in Greenhouse Recruiting. It also enables you to import job scorecards and plans from Interview GPS into Greenhouse Recruiting.
To install the Interview GPS Chrome Extension, search for the Interview GPS extension in the Chrome Web Store. Click Add to Chrome.
The Interview GPS Chrome extension will appear in the extension bin. The extension’s icon will appear as grey on most websites. When using Interview GPS or Greenhouse Recruiting, the extension’s icon will show in blue:
Once you have installed the Chrome extension, visit the Interview GPS Settings page. Visiting the Settings page when the Chrome extension is active automatically will connect your Chrome extension installation to your Interview GPS user account.
Edit and Import Job Scorecards
Interview GPS integrates with the Values, Competency, and Skills scorecard categories in Greenhouse Recruiting. If these categories do not exist yet, Interview GPS will create them the first time it adds any attributes for the relevant category.
You can retain any additional categories (such as Experience) that you might want to compare between candidates. Interview GPS will ignore these additional categories.
To edit the scorecard for a job, navigate to the Job Dashboard, then click Job Setup > Scorecard.
From the Scorecard page, click View Role on Interview GPS to open the job in Interview GPS.
Click Edit Role.
Select any Competencies or Skills that are necessary for the role, and then click Update Role.
If you have not already done so, configure the Core Values for your organization by clicking the Core Values button in the left-side navigation bar.
Toggle any Core Values for your organization.
Once you have configured your organization’s values and the job’s competencies and skills, return to Greenhouse Recruiting and navigate to the Job Dashboard > Job Setup > Scorecard. Click Import from Interview GPS.
The Scorecard page will refresh and you will see the Values, Competencies, and Skills you selected in Interview GPS. The other categories and their attributes will be unchanged.
Edit and Import Interview Plans
To edit the Interview Plan for a job, navigate to the Job Dashboard, then click Job Setup > Interview Plan.
From the Interview Plan page, click Open in Interview GPS at the bottom of the page to open the job in Interview GPS.
This will open the Interview Plan editor in Interview GPS. At this point the Interview Plan will be empty. As you add questions, the Plan Overview tab will show which interviews focus on which attributes.
To start, click Regenerate Template to have Interview GPS automatically fill the interviews with questions.
Alternatively, or in addition to pre-populating the interview, you can edit the questions in each interview manually.
When you are finished editing the interviews, click Save Interview Plan and then click Open in Greenhouse to return to the Interview Plan page in Greenhouse Recruiting.
When you return Greenhouse Recruiting, you will see an indication next to each interview whether it needs to be updated to match the plan in Interview GPS. For each interview that says UPDATE, click Edit to open the Edit Interview Kit page for the interview.
On the Edit Interview Kit page for the interview, click Import Guide. This will automatically do the following:
- Toggle the focus attributes for the Values/Competencies/Skills
- Add the questions/instructions/rubrics to the Interview Prep
You can verify the questions were added to end of the Interview Prep materials by scrolling down the Edit Interview Kit page:
Finally, click Save to save the updates to the Interview Kit and return to the Interview Plan page.
Repeat this process for each Interview Kit with an UPDATE status.
View Application Recommendations
When viewing an applicant’s Scorecards page, if you have the Interview GPS Chrome extension installed, an Interview GPS section will be added beneath the Overall Recommendation page.
Any scorecard analyses/recommendations from Interview GPS will be displayed here. You can also click View on Interview GPS to navigate to the Candidate Evaluation page for the candidate.
You also can access the Interview GPS Candidate Evaluation page by clicking the Interview GPS link from the All Candidates page.
Get Help
For troubleshooting assistance regarding the integration, please contact the Interview GPS Support team by emailing support@interviewgps.com.
You also can contact Support from within the Interview GPS platform by clicking the chat icon in the lower-right on any page.
For more information, please view the Interview GPS documentation by clicking here.