Bullhorn integration

How to use TestGorilla assessments with the Bullhorn ATS

You can connect TestGorilla to your Bullhorn account, allowing you to invite candidates to an assessment and see the summarized results inside Bullhorn. This article explains how that works. The Bullhorn integration is available on the Scale and Business plans and can be enabled by users with Admin or Owner access.

Please check with Bullhorn regarding the plan and access level needed on their side to make this work.

Approx. reading time 3 minutes

In this article

  1. Set up the integration
    1. Connect the integration
    2. Configure the integration
  2. Use the integration
    1. Invite candidates
    2. Status update tags
    3. Review results
  3. Disable the integration

Set up the integration

The integration between Bullhorn and TestGorilla is turned on from inside of your TestGorilla account.

Connect the integration

You must be a TestGorilla Admin or Owner to be able to complete this step.

From within the TestGorilla application:

1-1 Click your name in the top right corner of the browser and select the Integrations option from the drop-down menu.
2 Click the Enable button on the Bullhorn integration.
3 Select your cluster. To find out your cluster, visit Bullhorn’s help article about finding your cluster.
4 Press continue. Your TestGorilla API key will now appear inside of your TestGorilla account.
5 Copy your API key before heading into your Bullhorn account to continue the setup.

 

Configure the integration

You’ll need to check with Bullhorn to ensure you have the right plan and access level to be able to continue with this step.

From inside of your Bullhorn account

1-1 Click the Menu option on the left side of the screen.
2 Select Admin from the menu that appears.
3 Click View Layout from the submenu.
4 On the next screen, choose Candidate for the Field Map Entity dropdown.
5 Choose Custom Tabs from the row of options that appears across the screen and click the Add new button.
6

Fill in the form

  1. Enter the Name you’d like to use for the custom tab.
  2. Paste the Token link found below into the URL box. 
  3. Select the User Types that can access the tab.

Token link

https://bullhorn.testgorilla.com/api/v1/custom_tabs?token=<your TestGorilla API token>
7 Click on Save to save the Custom Tabs.

At this point, all new TestGorilla assessments will be available from within Bullhorn. Assessments made prior to activating the integration will not be available.

back-to-top

        Use the integration

        After you connect and configure the integration, you can proceed to invite your candidates and review their results within the Bullhorn platform. You'll need to create a new assessment to do this — assessments made prior to turning on the integration will not work.

        Invite candidates

        Applicants will be invited to an assessment through TestGorilla by clicking a few buttons inside of Bullhorn. In order to ensure that your candidate receives an email invitation to complete the appropriate assessment, follow the below steps:

        1-1 Within Bullhorn, select Menu found on the left side of the screen.
        2 From the menu that appears, choose Candidates.
        3 Once the candidate list loads, select the name of the appropriate candidate. This will load the details of that candidate.
        4 Find the TestGorilla Custom Tab - it will have the name that was given during the configuration step above.
        5 In the dropdown menu, select the name of the assessment that you’d like to invite the candidate to take.
        6 Click the Send Assessment button to send the invitation.

        back-to-top

         

        Status update tags

        To report on the candidate’s progress through the hiring journey, TestGorilla automatically assigns a status tag to each candidate:

        Status Meaning
        Acknowledged The invitation from TestGorilla was sent
        In progress The candidate has successfully started the assessment
        Completed  The candidate has successfully completed the assessment

         



        Review results

        The candidate results will be shared on the same screen, above the status, once the assessment has been completed. Included is:

        • An overall summary of their results (score out of 100)
        • A link to their candidate page in TestGorilla

        To view the full results, click Open to load the TestGorilla candidate results inside of the Bullhorn platform.

        back-to-top

        Disable the integration

        If you decide to switch ATS platforms or for some other reason no longer want to use the integration with Bullhorn, the TestGorilla account owner can disable the integration.

        1-1 In TestGorilla, click your name in the top right corner of the browser and select the Integrations option from the drop-down menu.
        2 Click the Disable button on the Bullhorn integration.
        3 Hit the Disable button on the popup that appears asking you to confirm your choice.

        back-to-top