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.
Create a Harvest API key for the Scoutible integration
To configure the Greenhouse Recruiting / Scoutible integration, you'll need to create a Harvest API key.
Follow the steps in this article to create the key, and verify that the credentials and permissions below are selected when configuring the Scoutible integration.
Credentials
In the Create New Credential box, make the following selections:
- API type: Harvest
- Partner: Scoutible
- Description: Scoutible Harvest API key
Permissions
Verify that the following permissions are selected for the Scoutible integration:
- 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.
Create an integration system user (ISU) for the Scoutible integration
Scoutible requires an integration system user (ISU) so that automated updates in candidate Activity Feeds are credited to the ISU.
Check out this article to create an ISU, and enter the following details when creating a user for Scoutible integration:
- User emails: support@scoutible.com
- User permission: Site Admin
When finished, click Save.
Create webhooks for the Scoutible integration
To integrate Scoutible with Greenhouse Recruiting, you'll need to create five (5) webhooks. Follow the steps in this article to create your webhooks. Use the values listed below to configure the webhooks:
Webhook 1
- 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
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
Create a custom candidate tag in Greenhouse Recruiting
Next, you will create a custom candidate tag for Played Scoutible which 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 to candidates who have played Scoutible.
To create a custom candidate tag, click Configure on your navigation bar, then select Custom Options on the left.
Click Candidate Tags.
Click Create New Candidate Tag.
Enter Played Scoutible.
Click Create Candidate Tag.
Note: It is important to enter the name of the candidate tag exactly as shown, including capitalizing both words.
Create a 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 don't 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.
Follow the steps in this article to create a custom email template, and 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/Scoutible (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}}
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 fields in Greenhouse Recruiting
In order to use the Scoutible integration, you need to set up three custom fields in Greenhouse Recruiting. These 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 Configure on your navigation bar, then click Custom Options on the left.
Click Jobs.
Click Add field.
Enter the following details:
- Field Name: Performance Predictor
- Type: Multi select
- Options:
Sales
Customer Service
- Options:
Note: Be sure the field name and options are entered exactly as shown, with each option on its own line.
When finished, click Save.
Next, create two custom candidate fields.
Click Configure on your navigation bar, then click Custom Options on the left.
Click Candidates.
Click Add field.
Enter the following details:
- Field Name: Performance Prediction
- Type: Number
When finished, click Save.
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
- Options:
Note: Be sure the field name and options are entered exactly as shown, with each option on its own line.
When finished, click Save.
That is it! Your Greenhouse Recruiting / Scoutible integration is now complete and ready for use.
Additional resources
For additional information or troubleshooting not covered here, reach out to support@scoutible.com.