Enabling Outcome Data and Public Link with Greenhouse

Last updated: December 27, 2024

Overview

A HackerRank Public Link helps you assess a candidate's skills before they even enter your ATS system. With this feature, any candidates with the link can take the test without having to be invited. If you are a Greenhouse user then after taking an assessment from a public link, a candidate profile will be automatically created within your Greenhouse account. 

You can map your test to a particular job on Greenhouse and obtain detailed candidate test reports for that job role whenever a candidate attempts the test on HackerRank.

What’s more, with HackerRank’s Test Health Dashboard, you can now get a full view of your complete conversion funnel, right from the initial invite and engagement through who finally received an offer.

Importance of Outcome Data

A high score on a test does not always mean a hire. This is where the data through the test invite to offer (outcome data) come in handy. If you knew what scores were given to the candidates who made it through, it might throw extra light on the difficulty level of the test.

Outcome Data also helps you understand how efficient your hiring funnel is and the ratio of the candidates you invite for a test to candidates that you hire.

THD_Updated.png

When Outcome Data is not enabled for your account, the candidate performance funnel in your test health dashboard looks like the below image.

Candidate_Performance_Funnel.png

If you are a Greenhouse customer, you can unlock the offered stage by providing HackerRank with your outcome data through an automated connection to your ATS.

Enabling Outcome Data and Public Link for Greenhouse 

Prerequisites

Steps

Inside Greenhouse

  • Open the Settings tab and go to API Credential Management.

    API_Credential_Management.png

  • Click Create a New API Key.

    Create_New_API_Key.png

  • Enter key name, choose Harvest Key, and create the key.

    Create_New_Credentials.png

  • For Outcome Data, choose the following permissions:
    Under “Applications”
    GET: Retrieve Application
    GET: List Applications

  • For Public Link, choose the following permissions:

    Under “Candidates”
    POST: Add Attachment
    POST: Add Note

    Under “Departments”
    GET: Retrieve Department


    Under “Jobs”
    GET: List Jobs

    Under “Tags” - all permissions
    POST: Add New Candidate Tags
    DELETE: Remove Tag from Candidate
    GET: List Tags Applied to Candidate
    GET: List Candidate Tags
    PUT: Add a Candidate Tag
    DELETE: Remove Candidate Tags

         Under “Users”
         GET: List Users

  • Don’t forget to click Update to save the permissions.

    Permissions.png

Inside HackerRank

  • Go to HackerRank ATS Settings page for Greenhouse Settings>ATS Integrations>Greenhouse

  • In the Greenhouse API Key step, enter the Harvest API token you created on Greenhouse, and click Save.

    Greenhouse_API_KEy.png

For Outcome Data

  • In the Candidate benchmarking and test outcome section, select Sync Outcome Data.

  • Once done, it will verify the permissions for the key and if everything goes well, you will see the green check box.

    Candidate_Benchmarking.png

  • In case your key is missing permissions, you will see an error message. In this case, go back to Greenhouse and enable proper permissions for Outcome Data then come back and click “Try Again”

    Candidate_Benchmarking_Try_Again.png

For Public Link

  • You can enable Public Link access and generate a public link for each test from the Test Settings for that test.

  • Refer to the📄 Modifying Test Access Settingsarticle to create a public test URL in case your test does not have one.

Note: If you do not see any errors after enabling “Sync Outcome Data”, you will see the outcome data in the Test Health Dashboards for all your tests within 24-48 hours. Data refreshes once a day.

Frequently Asked Questions

  1. I have entered a Harvest API Token. Why can I still not see the Outcome Data?
    If all your permissions are correct, then you will see Outcome Data in Test Health Dashboard in the next 24 - 48 hours.
    If you are getting an error, please ensure that you have enabled the correct permissions for your Greenhouse Harvest API Key. You can find this in Step 5 of the “Inside Greenhouse” section of this document.

  2. All my permissions are correct and my Test Health Dashboard is blank.
    The Test Health Dashboard is a current indicator of your Test Performance. Hence, it only shows data for the last 90 days. If your test has had no activity in the last 90 days, you will not be able to see insights into your Test Health.

  3. Where can I see Outcome Data on a company level?
    Today, we are using the Outcome Data as an indicator of your Test performance. Hence, it is available inside your Test Health Dashboard.
    We are working to provide you with more insights using this information. Please reach out to your HackerRank representative for requests or feedback on how you would like to see this Outcome Data.

  4. How can I enable Public Link for a test?
    This document ensures that you enable the connection for successfully pushing candidate information inside Greenhouse.
    You can enable Public Link for specific tests from “Test Settings” by following this document:📄 Modifying Test Access Settings