How can we help you?

Journeyfront

Journeyfront uses the latest advances in predictive analytics, psychometric assessments, and machine learning algorithms to improve the accuracy of hiring and get more people into jobs where they will thrive. 

Greenhouse Recruiting's integration with Journeyfront uses a brief assessment to evaluate the traits of your best (and worst) employees to create a model of the ideal hire, including attributes such as interests, values, competencies, and personality. Candidate assessments are measured against this data, so you can better predict performance and likelihood of turnover. In this article, we will cover how to: 

 

Configure User Setup Permissions in Greenhouse Recruiting

Contact a Greenhouse user in your organization with Site Admin level permissions with the additional user-specific permission Can edit another user's advanced permissions.

Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon configure.png > Users > Your Name.

Configure_-_Users.png

The user with Site Admin level permissions should navigate to the Permissions panel on your user page and expand the Developer Permissions dropdown menu.

Select Can manage and configure web hooks and Can manage ALL organization's API Credentials so a check is in each checkbox. When finished, click Save.

Two_permissions.png

In addition to the above developer permissions, the user configuring the integration should also have a Site Admin permission level or a Job Admin permission level with the following additional user-specific permissions: 

  • Can manage custom fields
  • Can create new job stage names (Job Admin only) 

 

Create a Harvest API Key for the Greenhouse Recruiting / Journeyfront Integration

To create a Harvest API key for the integration, click on 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

Dev_Center_-_API_Credential_Management.png

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

Create_new_API_key.png

From the Create new credential dialog box, give your API key a name and select Harvest from the Type dropdown menu. When finished, click Create

mceclip0.png

On the Manage API Key Permissions page, expand the Applications dropdown and grant the API key the following permissions: 

  • GET: Retrieve Application
  • PATCH: Update Application
  • POST: Advance Application
  • POST: Add Attachment to Application

mceclip1.png

Click Update at the bottom of the page when finished.

Your Harvest API key for the Greenhouse Recruiting / Journey integration is created and configured. Navigate to your newly created Harvest API key and click Copy. Provide your Harvest API key to your Journeyfront onboarding team so they can set up the integration. 

mceclip2.png

 

Share User ID with Journeyfront

In order for Journeyfront to make automatic updates in Greenhouse Recruiting, Journeyfront will need the user ID of an existing Greenhouse user in your organization, or the user ID for a Greenhouse Recruiting user account that is created specifically for Journeyfront.

The user should have Site Admin level permissions if you want Journeyfront to have access to all jobs for the integration, or Job Admin: Standard permissions if you want to specify each job the integration can access. 

Note: For information on how to create a new user, click here

To locate the user ID for either an existing user or for the new Journeyfront-specific user if applicable, click the Configure icon configure.png in the upper right-hand corner and select Users from the left-hand panel.

Configure_-_Users.png

From the Users page, click Export to Excel.

mceclip3.png

A spreadsheet will be downloaded to your computer. From the spreadsheet, navigate to the User ID column and copy the user ID value inline with your selected user.

Screen_Shot_2019-09-23_at_2.13.47_PM.png

Share the User ID with your Journeyfront representative. 

 

Create the Journeyfront Web Hook

The web hook will send information to Journeyfront when a new application is submitted to Greenhouse Recruiting. To create the web hook, 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 Web Hooks

Dev_Center_-_Web_Hooks.png

Click Web Hooks from the subsequent page. 

mceclip4.png

You will be directed to a page where you can create a new web hook. From this Create A New Web Hook page, provide the following details: 

Click Advanced settings... and add the following information: 

  • Maximum Attempts: 4
  • Disabled?No

mceclip5.png

When finished, click Create Web Hook

That is it! Your Greenhouse Recruiting account and Journeyfront account can now talk to each other. 

 

Configure Custom Job Field for the Greenhouse Recruiting / Journeyfront Integration

Data will be sent between your Greenhouse Recruiting account and Journeyfront, with some of this information stored in a custom job field. Use the following steps to create the required custom job field for the Greenhouse Recruiting / Journeyfront integration. 

Click the Configure icon configure.png in the upper right-hand corner. Navigate to Custom Options on the left-hand panel. 

mceclip6.png

Click Jobs from the subsequent page. 

mceclip7.png

Click + Add Field

mceclip8.png

Add the following details to the Create New Job Field dialog box: 

  • Field name: Journeyfront Assessment Link
  • Description: Unique Journeyfront assessment link for each job req
  • Type: Short textbox 

Screen_Shot_2019-11-26_at_10.44.37_AM.png

Click Save when finished. 

Note: Be sure to enter the field name exactly as specified. The names must match for the integration to work properly. 

 

Configure Journeyfront Stages on Job's Interview Plan

Two unique stages must be created for each job that will be administering Journeyfront assessments. Follow the steps below to create the stages, repeating for each applicable job. 

Note: Be sure the stage names are exactly as specified below. The names must match for the integration to work properly. 

Click All Jobs from the navigation bar, then select the job to which you wish to add a Journeyfront assessment. 

mceclip0.png

Click the Job Setup tab, then click Interview Plan in the left-hand panel. From the Interview Plan page, click + Add a Stage

mceclip1.png

Create a new stage called Journeyfront Assessment Sent. Click Add

Screen_Shot_2019-11-26_at_10.47.56_AM.png

Click + Add a Stage again and create a second stage called Journeyfront Assessment Complete

Note: If you want an email automatically sent to the candidate when they first apply to the job, be sure the two newly created created stages are placed directly after the Application Review Stage. 

Next, you must add a Journeyfront Assessment link to each job which will use the Greenhouse Recruiting / Journeyfront integration. Each job will have a unique link for candidates, provided by Journeyfront. 

To obtain a Journeyfront Assessment link, log into your Journeyfront account and click Hire, then click the name of the SmartReq you want to link to in Greenhouse Recruiting. 

Click Actions Invite Applicants, then copy the invitation link. 

Return to Greenhouse Recruiting, then click All Jobs from the navigation bar and select the job where you wish to add the Journeyfront assessment link. 

mceclip0.png

Click the Job Setup tab, then click Edit inline with Job Info

mceclip2.png

Scroll down to find the Journeyfront Assessment Link custom job field, and click the pencil icon to edit. Paste the link that was copied from Journeyfront into the field. 

Screen_Shot_2019-11-26_at_10.48.59_AM.png

Click Save

Repeat these steps for each job req on which you wish to send Journeyfront assessments. 

 

Test the Greenhouse Recruiting / Journeyfront Integration 

To ensure the integration is configured correctly and you are receiving candidate data in Greenhouse Recruiting, add a test candidate to one of the jobs that has a Journeyfront assessment link. Be sure to use an email address that is different from the email address you use to access Greenhouse Recruiting when adding the candidate to the job. 

Next, navigate to the job where you added the candidate and verify the candidate has been automatically moved to the Journeyfront Assessment Sent stage. 

Check the inbox for the email address you added to the candidate and verify the test candidate received an email from Journeyfront inviting the candidate to take the assessments. 

Click the link in the email, create a Journeyfront account, and complete the Journeyfront assessments. 

Wait ten minutes, or work with the Journeyfront team, to send the completed candidates back to Greenhouse Recruiting. 

In Greenhouse Recruiting, verify the test candidate has been advanced to the Journeyfront Assessment Complete stage. 

Verify the Journeyfront field on the application has been populated. 

Click on the Journeyfront scorecard link to ensure you can see the complete candidate scorecard. 

 

Get Help

Contact support@journeyfront.com for troubleshooting assistance regarding the integration.