Scoutible is a next-generation AI for hiring, using immersive video games to identify perfect-fit candidates for jobs. Scoutible's technology identifies a person's unique cognitive and personality traits from their gameplay, and connects them with open jobs where they are virtually certain to be a top performer.
In this article, we will cover:
- Configure user setup permissions in Greenhouse Recruiting
- Create Harvest API key for the Greenhouse Recruiting / Scoutible integration
- Create custom Scoutible user in Greenhouse Recruiting
- Create webhooks for the Greenhouse Recruiting / Scoutible integration
- Create custom candidate tag in Greenhouse Recruiting
- Create custom email template in Greenhouse Recruiting
- Create custom job field in Greenhouse Recruiting
- Create custom candidate fields in Greenhouse Recruiting
- Get help
Note: Watch this short video to understand the Scoutible features that will be available in your Greenhouse Recruiting account after you complete these instructions.
Configure user setup permissions in Greenhouse Recruiting
In order to enable the Greenhouse Recruiting / Scoutible integration, you will need the following developer permissions:
- Can manage ALL organization’s API Credentials
- Can manage and configure web hooks
- Can invite new users to Greenhouse and reactivate disabled users
- Can manage custom fields
- Can manage company metadata
- Can manage company email and social media templates
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 necessary permissions to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to Configure > Users > Your Name.
The user with Site Admin level permissions should navigate to the User-Specific Permissions panel on your user page and expand the Developer Permissions dropdown menu.
Select Can manage ALL organization’s API Credentials and Can manage and configure web hooks so a check is in each checkbox. The Site Admin also should assign the user-specific permissions noted above to the user account if needed. When finished, click Save.
Repeat as necessary for any other user that should have access to set up the integration.
Create Harvest API key for the Greenhouse Recruiting / Scoutible integration
Next, you will create a Harvest API key for the Greenhouse Recruiting / Scoutible integration.
What is it? You need to set up Greenhouse’s Harvest API so that Scoutible can receive data about your candidates and jobs.
Why do this? This will enable candidates to play Scoutible games, and it will enable Scoutible to provide you with insight about your candidates.
To create a Harvest API key for the integration, 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 API Credential Management.
From the API Credential Management page, click Create New API Key to generate the API key for Scoutible.
In the Create New Credential dialog box, make the following selections:
- API Type: Harvest
- Partner: Scoutible
- Description: Scoutible Harvest API Key
When finished, click Manage Permissions to generate the Harvest API key and automatically assign it the appropriate permissions required by Scoutible.
In the subsequent dialog box, click Copy to save your API key to your clipboard. Store the API key in a secure location to provide to Scoutible in the next step. Click I have stored the API Key once you have copied and saved the key.
Note: You cannot access the full API key again after clicking I have stored the API Key. If you lose your API key and need to access it later, you must create a new API key, provide it to the integration partner, and then revoke access to the original key.
On the subsequent page, confirm the following permissions are assigned to your new API key:
- Activity Feed
- Applications
- Candidates
- EEOC
- Job Posts
- Jobs
- Rejection Reasons
- Tags
- Users
If any of the permissions above are not checked, place a check in the box next to the appropriate permission. Click Save when finished.
Your Harvest API key for the Greenhouse Recruiting / Scoutible integration is created and configured. Paste the API key into the body of an email and send it to support@scoutible.com with your company name as the subject line.
- Adding a note: https://harvest.greenhouse.io/v1/candidates/{candidate_id}/activity_feed/notes
- Finding the tag ID for Played Scoutible: https://harvest.greenhouse.io/v1/tags/candidate
- Applying a Played Scoutible tag: https://harvest.greenhouse.io/v1/candidates/{candidate_id}/tags/{tag_id}
- Getting candidate info for email update as well as updating candidate with top soft skills: https://harvest.greenhouse.io/v1/candidates/{candidate_id}
- Getting EEOC data: https://harvest.greenhouse.io/v1/applications/{application_id}/eeoc
- Getting all candidates in a job: https://harvest.greenhouse.io/v1/candidates?job_id={job_id}
Create custom Scoutible user in Greenhouse Recruiting
What is it? You need to set up a fake user called Scoutible System, so that automated updates in candidates’ Activity Feeds come from this user.
Why do this? A user entity is required to automatically send Notes to Candidate Activity Feeds.
To create the Scoutible System user, click the Configure icon in the upper right-hand corner. Navigate to Users on the left-hand panel.
From the Users page, click + New Users.
On the Add New Users page, provide the following information:
- Enter user emails: support@scoutible.com
- Set permissions: Site Admin
When finished, click Save.
Create webhooks for the Greenhouse Recruiting / Scoutible integration
What is it? You need to set up webhooks so Scoutible can detect when you receive applicants to your jobs.
Why do this? This will enable the auto-invite feature where Scoutible automatically invites all candidates to your job without you having to manually invite anyone.
Before enabling the Greenhouse Recruiting / Scoutible integration, reach out to the Scoutible team to receive your secret key.
To create the webhooks, click the Configure icon in the upper right-hand corner and navigate to Dev Center on the left-hand panel. From the Dev Center page, click Web Hooks.
Click Web Hooks from the subsequent page.
On the Create A New Web Hook page, provide the following details to create your first webhook:
- Name: Scoutible invite
- When: Candidate has submitted application
- Endpoint URL: https://api-dot-scoutible-app.appspot.com/api/v1/integrations/greenhouse
- Secret Key: The secret key received from the Scoutible team
- Error recipient email: support@scoutible.com
- Advanced settings > Additional HTTP Headers: The org key received from the Scoutible team
When finished, click Create Web hook.
Repeat the steps above to create four additional webhooks:
Webhook #2:
- Name: Job updated
- When: Job updated
- Endpoint URL: https://api-dot-scoutible-app.appspot.com/api/v1/integrations/greenhouse/job
- Secret Key: The secret key received from the Scoutible team
- Error recipient email: support@scoutible.com
- Advanced settings > Additional HTTP Headers: The org key received from the Scoutible team
Webhook #3:
- Name: Rejected
- When: Candidate or Prospect rejected
- Endpoint URL: https://api-dot-scoutible-app.appspot.com/api/v1/integrations/greenhouse/rejected
- Secret Key: The secret key received from the Scoutible team
- Error recipient email: support@scoutible.com
- Advanced settings > Additional HTTP Headers: The org key received from the Scoutible team
Webhook #4:
- Name: Hired
- When: Candidate has been hired
- Endpoint URL: https://api-dot-scoutible-app.appspot.com/api/v1/integrations/greenhouse/hired
- Secret Key: The secret key received from the Scoutible team
- Error recipient email: support@scoutible.com
- Advanced settings > Additional HTTP Headers: The org key received from the Scoutible team
Webhook #5:
- Name: Email updated
- When: Application updated
- Endpoint URL: https://api-dot-scoutible-app.appspot.com/api/v1/integrations/greenhouse/update-candidate
- Secret Key: The secret key received from the Scoutible team
- Error recipient email: support@scoutible.com
- Advanced settings > Additional HTTP Headers: The org key received from the Scoutible team
That is it! Your Greenhouse account and Scoutible account can now talk to each other. These settings dictate execution of the Scoutible webhooks once the end user transitions the candidate into an appropriate application stage for a given job.
Create custom candidate tag in Greenhouse Recruiting
Next, you will create a custom candidate tag for Played Scoutible.
What is it? You need to set up a new candidate tag called Played Scoutible.
Why do this? This will allow you to filter between candidates who have played the Scoutible games and those who have not. This is important because the Performance Predictor results and Top Soft Skills are only available on candidates who have played Scoutible.
To create a custom candidate tag, click the Configure icon in the upper right-hand corner and navigate to Custom Options on the left-hand panel. From the Custom Options page, click Candidate Tags.
From the Manage Candidate Tags page, click Create New Candidate Tag.
In the subsequent dialog box, enter Played Scoutible. Click Create Candidate Tag when finished.
Note: It is important to enter the name of the candidate tag exactly as shown below, including capitalizing both words.
Create custom email template in Greenhouse Recruiting
Note: This step assumes Scoutible has created an invite microsite for you. This URL will be used in place of the highlighted URL found in the template body text below. If you do not have this URL, please contact Scoutible Support (support@scoutible.com) before completing this step. Otherwise, you may skip this step and move to the next step.
What is it? You need to set up an organization-wide email template.
Why do this? This enables you and other recruiters to manually invite applicants to play Scoutible games in case the auto-invite emails did not reach the candidate (spam filters sometimes filter out these emails).
To create a new email template, click the Configure icon in the upper right-hand corner and navigate to Email Templates on the left-hand panel. From the Email Templates page, click + New inline with Organization-Wide Templates.
On the subsequent page, enter the following information:
- Template Name: Scoutible Invite
- Type: Candidate Email
- Description: Invitation reminder for applicants who haven’t finished playing Scoutible.
- From Address:
{{MY_EMAIL_ADDRESS}}
-
Email Subject: You’ve been invited by
{{COMPANY}}
-
Body:
Hi
{{CANDIDATE_FIRST_NAME}}
,I’d like to invite you to play Scoutible mobile games as part of your application for
{{JOB_NAME}}
.We’ve partnered with Scoutible to provide a unique job application experience using mobile games, which detect the hidden strengths of applicants and highlight them for employers.
Follow the instructions here to get started: app.scoutible.com/[COMPANY] (MAKE SURE TO use the same email that you applied with:
{{CANDIDATE_EMAIL_ADDRESS}}
to register).If you encounter problems, email Scoutible Support (support@scoutible.com).
{{MY_SIGNATURE}}
When complete, the email template should look like this:
Click Save. You can now manually invite candidates to play Scoutible if needed.
Here is an example of what the email looks like when the candidate receives it:
Create custom job field in Greenhouse Recruiting
What is it? You need to set up three Custom Fields; one at the job level and two at the candidate level.
Why do this? This will allow you to select a Performance Predictor model when creating a job as well as use the numerical Performance Prediction result and the Top Soft Skills to filter your candidates. These are the primary features in the Scoutible integration that allow you to optimize your recruiting efforts by focusing on only the best candidates.
To create a custom job field, click the Configure icon in the upper right-hand corner and navigate to Custom Options on the left-hand panel.
From the Custom Options page, click Jobs.
From the Manage Job Fields page, click Add Field.
On the subsequent page, provide the following details:
- Field Name: Performance Predictor
- Type: Multi select
- Options:
Sales
Customer Service
Note: Be sure the field name and options are entered exactly as shown, with each option on its own line.
Click Save when finished.
Create custom candidate fields in Greenhouse Recruiting
Next, create two custom candidate fields. To begin, click the Configure icon in the upper right-hand corner and navigate to Custom Options on the left-hand panel.
From the Custom Options page, click Candidates.
From the Manage Candidate Fields page, click Add Field.
On the subsequent page, provide the following details:
- Field Name: Performance Prediction
- Type: Number
Click Save when finished.
Repeat the steps above to create one more custom candidate field using the following details:
- Field Name: Top Soft Skills
- Type: Multi select
- Options:
Analytical
Communicator
Creative
Diligent
Flexible
Hardworking
Leader
Perfectionist
Team-Player
Visionary
Note: Be sure the field name and options are entered exactly as shown, with each option on its own line.
Click Save when finished.
That is it! Your Greenhouse Recruiting / Scoutible integration is now complete and ready for use.
Get help
For troubleshooting assistance regarding the integration, please contact support@scoutible.com.