Enabling and using the Predictive Index integration by Joynd

Available for User roles Super Admin, Admin, Team Member, Limited Team Member
Can only be configured by Super Admins
Packages All packages

Joynd is a fully-managed integration company that offers an integration between Lever and The Predictive Index (PI) integration that allows you to seamlessly assign candidates The Predictive Index assessments directly from your Lever dashboard. The Predictive Index will be notified when a candidate has reached a trigger stage in Lever. The candidate will automatically be added to your account in The Predictive Index and emailed a secure test link. Once the candidate has completed the test and the test has been scored by The Predictive Index, the PI report (PDF) will be available on your Lever dashboard.


You must be an existing PI customer and sign a contract directly with Joynd in order to enable this integration.


Costs include: 

  • One-time Joynd Setup Fee (could be waived based on company size)
  • Annual Joynd Subscription Fee (calculated based on PI subscription size and type of PI assessments)

Readers of this article will learn the following:

Setup the integration:

Note: Access role must be Super Admin in Lever to set up the integration.

To authorize Joynd to access your Lever account to facilitate the integration:

  1. Log into Lever.
  2. Open a new tab.
  3. Your Joynd Integration Manager will provide you with a link that is unique to your company’s integration.  Copy and paste this link into the address bar of the new tab.
  4. Lever will display a summary of the access that Joynd will have to your account.  Review the details and click Accept if you would like to proceed with the integration.

Lever authorize app modal with list of permissions and blue accept button.

Configure Webhook Notification

In order for Joynd to know when there’s an assessment request ready for PI, you will need to enable a webhook:

  1. In Lever, go to Settings > Integrations and API > Webhooks
  3. Select the Triggers for candidates of the selection origins that are relevant for the PI assessment.
  4. Copy the Signature token and provide to your Joynd Integration Manager.

Lever Integrations and API settings page webhooks tab showing candidate stage change section outlined.

Your Joynd Integration Manager will confirm when the integration is ready to use!

How to use the integration:

Adding the PI Assessment to the Job

Specify which PI assessment to order by adding a tag on the Job record.


You will need to create the tag the first time you order each PI assessment.

Possible values are:

  • PI=behavioral-only
  • PI=cognitive-only
  • PI=behavioral+cognitive

Lever platform job posting editor with Predictive Index tag outlined.

Initiating the assessment

When you add a Candidate to a Job, the Opportunity record will automatically show the tag with the PI assessment that you added to the Job in the step above:

Lever platform Candidate profile with Predictive Index tag outlined.

To initiate the assessment request, change the stage of the opportunity to Assessment:

Lever platform Candidate profile showing state change menu with assessment listing outlined.

If the order was successful, after a few seconds you will see the tag “PI Assessment:Ordered”.  If not successful, you will see “PI Assessment:Error”.

Lever platform Candidate profile with Predictive Index tag outlined.

Reviewing PI Assessment Results

Once the candidate has completed the PI assessment, the Opportunity record will be updated with the tag “PI Assessment:Completed” and there will be a new note added:

Lever platform Candidate profile with Notes tab and Predictive Index tag outlined.

When you click on the notes, you will see a link to the PI report. 

Lever platform Candidate profile showing Notes tab with Predictive Index update outlined.


The PI assessment report url can be pushed back as a “Secret” note in PI that only certain users can see or it can be not “Secret”.  Please advise your Joynd Integration Manager which approach you prefer to use.

When you click the link, the PI report PDF will be downloaded to your local computer for you to open and review:

Predictive Index platform showing candidate profile PDF

How to disable the integration:

1. Navigate to your Integrations & API Settings Page in Lever.

2. Under the Authorized Apps tab, locate the Predictive Index app.

3. Click Revoke Access to disable the integration.

Was this article helpful?
0 out of 0 found this helpful