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: 

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
Note: The user enabling the integration must either be a Site Admin, or be a Job Admin with the following additional user-specific permissions:
  • 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 Configure.png > Users > Your Name.

1._Configure_-_Custom_Options.png

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.

ALL_API___Web_hooks.png

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 Configure.png in the upper right-hand corner. Navigate to Dev Center on the left-hand panel. From the Dev Center page, click API Credential Management.

1._Dev_Center_-_API_Credential_Management.png

From the API Credential Management page, click Create New API Key to generate the API key for Scoutible.

2._Create_new_API_key.png

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.

mceclip4.png

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.

3._API_key_created.png

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.

Note: Scoutible Harvest API Endpoint URLs (for internal use only):

 

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 Configure.png in the upper right-hand corner. Navigate to Users on the left-hand panel. 

1._Configure_-_Users.png

From the Users page, click + New Users

Users_-___New_Users.png

On the Add New Users page, provide the following information: 

When finished, click Save

mceclip0.png

 

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 Configure.png in the upper right-hand corner and navigate to Dev Center on the left-hand panel. From the Dev Center page, click Web Hooks

1._Dev_Center_-_Web_Hooks.png

Click Web Hooks from the subsequent page.

2._Web_Hooks_-_Web_Hooks.png

On the Create A New Web Hook page, provide the following details to create your first webhook:

When finished, click Create Web hook.

mceclip1.png

Repeat the steps above to create four additional webhooks: 

Webhook #2:

Webhook #3: 

Webhook #4:

Webhook #5: 

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 Configure.png in the upper right-hand corner and navigate to Custom Options on the left-hand panel. From the Custom Options page, click Candidate Tags

Configure_-_Custom_Options_-_Candidate_Tags.png

From the Manage Candidate Tags page, click Create New Candidate Tag

Create_New_Candidate_Tag.png

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.

mceclip2.png

 

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 Configure.png 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

Email_Templates_-___New.png

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:

mceclip0.png

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:

scout_33.png

 

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 Configure.png in the upper right-hand corner and navigate to Custom Options on the left-hand panel. 

1._Configure_-_Custom_Options.png

From the Custom Options page, click Jobs

Custom_Options_-_Jobs_copy.png

From the Manage Job Fields page, click Add Field

Job_Fields_-_Add_Field.png

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.

mceclip1.png

 

Create custom candidate fields in Greenhouse Recruiting

Next, create two custom candidate fields. To begin, click the Configure icon Configure.png in the upper right-hand corner and navigate to Custom Options on the left-hand panel. 

1._Configure_-_Custom_Options.png

From the Custom Options page, click Candidates

Custom_Options_-_Candidates.png

From the Manage Candidate Fields page, click Add Field

Custom_Candidate_-_Add_Field.png

On the subsequent page, provide the following details: 

  • Field Name: Performance Prediction
  • Type: Number

Click Save when finished. 

mceclip2.png

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.

mceclip3.png

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