Integrating a Sense account to Bullhorn is the first step to get started with Sense if you're using Bullhorn. This document provides a high level overview of integration requirements.
API Authorization
The first step is to create a dedicated user with API access within your Bullhorn account that will be used by Sense to perform data syncing.
- Open a Bullhorn support ticket to request a new sense.api user that has REST access to your Bullhorn data. In the support ticket, request that the account is enabled for Web portal login and that the password will not be reset. Also request that the TOS is disabled for your API user.
- Set up READ permissions on the following entities in Bullhorn to the new sense.api user:- Candidates - Placements - CorporateUser - ClientCorporation- ClientContact- Interview/Appointment- JobOrder
- Provide the password, Client ID, and Client Secret associated with the sense.api user that Bullhorn provides to you to Sense
Data Validation & Mapping
After receiving the API credentials from a customer, we will perform a set of tests to verify that we have access to the appropriate entities via the Web portal and the REST API. In addition, we will map the Bullhorn entity fields to fields on our data models that represent the Audience members.
At this point, there may be custom field mappings that a customer may prefer for specific workflows that apply to their Sense setup. For example, if a specific customer uses a customText field within Bullhorn for a specific piece of data that they would like to be able to target an Event or Workflow on, we can identify and configure those settings within our ATS ETL system. Sense can also import a subset of Bullhorn records based on the specifics of the implementation.
Data Sync
During the initial data extraction from Bullhorn and loading into Sense, our ATS ETL system will perform a full dump of all the entities that we are granted access to and load them into the Sense platform. We use Bullhorn’s REST API endpoints request the full list of entity data. At this point, they will be visible from the USERS section of your Sense account.
After a customer has set up their Sense account with the desired Workflows, we will enable the constant syncing feature of our ATS ETL system. This feature uses the Subscription endpoint of the Bullhorn REST API to gather all updates that happen to any particular entity. We then apply these change, create, or delete events to the appropriate data models within the Sense platform for your account. At this point, your account is fully set up for Bullhorn ATS synchronization.
Once data is syncing to Sense, audiences are created within Sense to select the appropriate candidates and placements to run workflows against.
Bullhorn Tab
Sense further integrates into Bullhorn by exposing a tab within candidate record pages, allowing Bullhorn users such as recruiters to quickly view Sense data about candidates to help them make decisions and stay up to date. To learn more about the Bullhorn tab, click here.