Predictive Index (PI) integration by Flexspring

You must work with the third-party integration developer Flexspring to use the integration with Predictive Index. Reach out to Predictive Index Support to inquire about a subscription to the Flexspring integration with Greenhouse.

Costs:

  • One-time Setup Fee
  • Annual Subscription Fee
  • Fees calculated as a percentage of PI annual subscription

Greenhouse and The Predictive Index (PI) have created an integration through a provider named Flexspring so that your organization can seamlessly add PI assessments to your Greenhouse interview pipeline and see results in Greenhouse Recruiting.

Set up the Predictive Index account for the integration

Organizations must have a Predictive Index subscription to configure this integration. You can sign up for a Predictive Index subscription by filing a business inquiry.

To begin setup, contact your PI integration team about a subscription to the Flexspring integration with Greenhouse. The PI integration team will work with you and Flexspring to arrange your contract with Modulus Data to pay the integration setup and annual subscription fees.

Create a Harvest API key for the Predictive Index integration

To configure the Greenhouse Recruiting / Predictive Index 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 Predictive Index integration.

Credentials

In the Create New Credential box, make the following selections:

  • API Type: Harvest
  • Partner: The Predictive Index
  • Description: The Predictive Index by Flexspring Harvest API Key

Permissions

Select all available permissions using the Select All checkbox at the top of the list.

Note: The Predictive Index integration uses Select all to grant all permissions. These permissions may be more than your integration needs to function, but ensures that the integration continues to function as the Predictive Index evolves its functionality.

Once it's generated, provide your Harvest API key to your PI integration technician so they can set up the integration.

Create a webhook

To integrate Predictive Index with Greenhouse Recruiting, you'll need to create a webhook. Follow the steps in this article to create your webhook. Use the values listed below to configure the webhooks.

You will need to create two webhooks for this integration.

Webhook 1: Greenhouse Recruiting to Predictive Index Assessment Request

  • Name: PI Stage Changed
  • When: Candidate has changed stage
  • Endpoint URL: The Endpoint URL received from the Predictive Index
  • Secret Key: The Secret Key received from the Predictive Index
  • Username: The credentials provided by Flexspring
  • Password: The credentials provided by Flexspring

Webhook 2: PI to Greenhouse Recruiting Results

  • Name: PI Refresh BA or CA
  • When: Candidate or Prospect Updated
  • Endpoint URL: The Endpoint URL received from the Predictive Index
  • Secret Key: The Secret Key received from the Predictive Index
  • Username: The credentials provided by Flexspring
  • Password: The credentials provided by Flexspring

Adding a Job Target in Predictive Index

Add a Job Target to the PI system that describes the range of ideal employees for any Job you intend to define in Greenhouse Recruiting. To make sure this information is included in the integration, you'll need to set up a Job Target in Predictive Index.

In Predictive Index, click Create Job under the Hire header and complete the fields. Then, choose a method for behavioral and/or cognitive targets and finish the setup process.

Define custom fields

Note: This step can only be completed after the Flexspring team configures custom fields for your integration.

After the custom fields are configured by Flexspring, you can select the correct Predictive Index values in Greenhouse Recruiting. These fields are located under the Job Info tab for each job you want to integrate with Predictive Index.

You'll need to define the following fields:

  • Pi_assessment_type: Behavioral or Both (Behavioral and Cognitive)
  • Pi_process_stage: The interview stage where PI Assessments should be sent.
  • Pi_job_target: The job in Predictive Index. The list of jobs is automatically updated from the PI system nightly. If you need a job to appear right immediately in the list, a Site Admin can add the PI Job Target Name to the custom job field options.

Create an assessment stage in your interview plan

You can create a separate interview stage to send Predictive Index assessments. Modify an interview plan and add the following stages:

  • Send assessments: Used to send an email to the candidate with the Predictive Index Assessment
  • Take Home Test: A special Greenhouse Recruiting stage used to actually send assessments to candidates.

Configure interview stages

Once you've added the stages above, make the following modifications to the interview plan:

  • Remove all interviews from the Send Assessment stage. Since scorecards won't be sent for this stage, they are not needed.
  • Update the name of the Take Home Test stage to Pre-Assessment Email, or a similar title of your choosing.
  • Update the name of the content in this stage to Acknowledge App and Intro Assessment, or a similar title of your choosing.
  • Under the stage settings, deactivate the following features:
    • Link for candidates to submit tests
    • Graders and Notifications
    • Additional Settings

Send an assessment

When a candidate is moved to the Pre-Assessment Email Stage, a Send Test link will display. Click this link to send an email to the candidate. While this button is selected in Greenhouse Recruiting, the emails will actually be sent by Predictive Index.

When a candidate is moved into Send Assessments, Predictive Index will be notified to send an assessment to the candidate.

Once the candidate has completed their assessments, the custom candidate fields will be automatically updated with relevant information:

  • pi_assessment_state_ba: Shows as "Complete" if a candidate was assigned a behavioral assessment
  • pi_assessment_state_ca: Shows as "Complete" if the candidate was assigned a cognitive assessment.

Additionally, a candidate's results will display in this field.

A PDF version of the results will automatically be attached to the candidate's profile.

 

Custom fields setup (Flexspring reference)

Note: This section is intended for the Flexspring team as they configure the integration. Do not attempt to perform this work yourself, as changing or incorrectly creating custom fields may cause issues with your integration.

The following custom Greenhouse fields are required for the integration. These should be created during the implementation phase by the Flexspring integration technician. Creating these fields incorrectly will require custom fields to be maintained for your integration.

Custom job fields

Create three custom job fields using the following criteria:

Custom job field 1: Assessment Type

  • Field Name: pi_assessment_type
  • Type: Single Select
  • Description: Behavioral only or Both Behavioral and Cognitive

Custom job field 2: Process State

  • Field Name: pi_process_stage
  • Type: Single Select
  • Description: Determines which completed stage will trigger PI assessment invitation(s) to be sent

Custom job field 3: Job Target

  • Field Name: pi_job_target
  • Type: Single Select
  • Description: Select a job from the list of defined Jobs in PI software to be assigned to candidates who have applied for this Job upon reaching the assessment stage.

Custom candidate fields

Create custom candidate fields using the following options:

Field Name

Type Private Description
pi_assessment_state_ba Short textbox No “Sent” or “Completed” or “Error: {detail}”
pi_assessment_state_ca Short textbox No “Sent” or “Completed” or “Error: {detail}”
pi_fit_score_ba Short textbox No Whole number between 1 and 10 or N/A
pi_fit_score_ca Short textbox Yes Whole number between 1 and 10 or N/A. Some clients may want this private, some are okay letting it be seen by users since it is a relative, not absolute, score.
pi_fit_score Short textbox No Decimal number e.g. 7.5 or 9 or 3
pi_fit_score_level Short textbox No Computed (High, Medium, Low) based on pi_fit_score ranges (>=8, >=4, else)
pi_reference_pattern_name Short textbox No Reference profile (e.g. Captain, Controller)
pi_reference_pattern_descr Short textbox No One sentence description ofreference profile
pi_person_page_url URL No Clickable link to PI Person Details
pi_descriptive_report_page_url URL No Clickable link to PI Report Options
pi_cognitive_score Short textbox Yes Score of the cognitive assessment.
pi_cognitive_percentile Short textbox Yes Percentile of the cognitive assessment.
pi_assessment_user_id Short textbox No ID of the Person in PI platform
pi_assessment_id_ba Short textbox No ID of the Behavioral assessment.
pi_assessment_id_ca Short textbox No ID of the Cognitive assessment.
pi_take_ba_assessment URL No URL sent to the candidate to take the Behavioral assessment. Use only for providing support to candidate.
pi_take_ca_assessment URL No URL sent to the candidate to take the Cognitive assessment. Use only for providing support to candidate
pi_refresh_ba Yes/No No Change to Yes and save to reload the Behavioral assessment and Job Fit data and associated reports
pi_refresh_ca Yes/No No Change to Yes and save to reload the Cognitive assessment data and report