Overview
Bullhorn Automation, previously known as Herefish, helps automate recruitment workflows by syncing job data across platforms. You can implement this using:
A direct Bullhorn integration, or
An indirect integration through platforms like Broadbean (or similar tools such as Logic Melon).
This guide walks through both scenarios to ensure proper setup and candidate redirection.
Key Benefits
Time Savings: Automate repetitive tasks like job syncing and candidate engagement.
Improved Candidate Experience: Ensure jobseekers are redirected seamlessly to your branded job pages.
Consistency Across Platforms: Maintain accurate and consistent job listings.
Compatibility with Third Parties: Works with Broadbean, Logic Melon, and other distribution platforms.
Custom Automation: Tailor workflows to fit specific recruitment processes.
Integration Requirements
To use Bullhorn Automation effectively, you'll need:
Access to Bullhorn Automation
A script from Bullhorn Automation
Job reference number formatting (for non-direct integrations, e.g. Broadbean)
Admin access to your Access Volcanic site
Step 1: Identify Your Integration Type
Check your current integration setup:
If using a Bullhorn integration, skip to Step 3.
Step 2: Broadbean etc. – Format Job References
When using Broadbean (or similar), job references must be reformatted so that Bullhorn can recognise them.
What needs to be removed from job references:
Prefix like
BBBHAnything following an underscore (_)
Example:
Original: BBBH13545_1612246072
Reformatted: 13545
📌Note: Broadbean can assist in reformatting the job reference field.
This step ensures the jobs posted through Broadbean appear correctly in Bullhorn with matching references.
Step 3: Add the Bullhorn Automation Script
Once you have received the Bullhorn Automation script, you need to add it to your site’s header code.
Steps:
Log into Volcanic as an admin
Click the Your Website tab at the top.
Click Page Tags (under SEO Area).
Select the Header Code section.
Paste the script into the Header Code field.
Click Submit to save changes.
Example Script
<script type="text/javascript">
window.hfAccountId = "XXXXXXXXX";
window.hfDomain = "https://api.herefish.com";
(function() {
var hf = document.createElement('script');
hf.type = 'text/javascript';
hf.async = true;
hf.src = window.hfDomain + '/scripts/hf.js';
var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(hf, s);
})();
</script>
Set Up External Apply Redirects
To ensure job board applications (e.g., from Indeed) redirect correctly to your job pages:
Use the following URL format:
{yourdomain}/j/{job_ref_on_Bullhorn}
Example
https://www.example.com/j/13545
This ensures candidates who click “Apply” on job boards (like Indeed) are redirected to your branded job pages.
📌Note: For more information, refer to Bullhorn’s article on Enabling AI Job Match.
FAQs
Q1: Can I use this with other tools besides Broadbean?
Answer: Yes. If the third-party integration (e.g., Logic Melon) allows reference formatting, the setup should work similarly.
Q2: What if the script doesn’t work?
Answer: Confirm it’s placed in the Header Code section. Reach out to Bullhorn support if issues persist.
Q3: Do I need to format job references with a direct Bullhorn integration?
Answer: No. This step is only needed for Broadbean or similar indirect integrations.
Q4: Where can I get the script?
Answer: From your Bullhorn Automation representative or Bullhorn support.
Q5: Where exactly is the Header Code section on my Volcanic site?
Answer: It's located in the Volcanic admin area. Use the steps below:
Log into the Admin Area
Click the Your Website tab
Click Page Tags
Q6: What happens if I don’t format the job reference correctly?
Answer: If job references still include prefixes like BBBH or extra characters, Bullhorn may not match them correctly, and the automation won’t work as expected.
Q7: Do I need to manually reformat job references for every job post?
Answer: No. Broadbean and similar platforms can be configured to do this automatically. You can contact Broadbean for help via email at [email protected], phone at 0800 464 3333, or use their contact form.
Q8: How can I tell if the Bullhorn Automation script is working?
Answer: After setup, check your Bullhorn Automation dashboard for activity or test by submitting a job application. If in doubt, contact Bullhorn support.