Setting up your Bullhorn integration - Part 1: Setting up the idibu iframe url

This article will walk through each step required to complete the foundation for setting up your Bullhorn integration. It’s the first stage in your setup of either Bullhorn, or Bullhorn Novo. This is to create a bespoke URL, that will then be inserted into a custom tab inside your Bullhorn account.

Here's what we’ll cover:

1. Creating unique ID and Secret tokens to insert into your URL
2. Using your tokens to create your URL - key points
3. Creating your URL, step by step
4. What happens when a user opens the idibu tab?
5. What happens if a Bullhorn user does not have an idibu profile yet?
6. Syncing new users to a default group inside idibu
7. How to sync new users to a default group
8. Adding the group logic to your URL
9. Next steps

Creating your unique ID and Secret tokens

When we talk about creating your ID and Secret tokens, the word ‘token’ might sound a little misleading if you are not familiar with the term. All we mean by this is a unique letter and number code that is generated automatically for both values.

In this article we take you through each step of the process. As long as you have administrator level access in your idibu account you won’t need any other specialist tools or knowledge.

Once you have created these tokens, you will be ready for the next step.

Using your tokens to create your URL

Having created your tokens following the steps in the article above, all you now need to do is copy them into a URL template we’re going to give you. This is quite straight forward but the key things to watch are that:

1. You copy every character in each token
2. Insert them into the correct part of the url.

For this step we’d suggest opening Notepad, or a similar ‘plain text’ application. If you are using a Mac, we like ‘Sublime Text’ as an App for this sort of thing - but any plain text application will do.

Creating your URL, step by step

1. Here is the basic URL template we are going to work with. Ensure you use the correct template, depending on whether you are using Bullhorn Novo or Bullhorn S-Release:

Bullhorn Novo:

https://v3.idibu.com/c/integration/bullhornnovo/id/VALUE_FOR_ID/secret/VALUE_FOR_SECRET/data_center/

Bullhorn S-Release:

https://v3.idibu.com/c/integration/bullhorn/id/VALUE_FOR_ID/secret/VALUE_FOR_SECRET/data_center/

2. Copy this into your text document.  

3. The parts you will be changing are 'VALUE_FOR_ID' and 'VALUE_FOR_SECRET'. You will also be adding your allocated Bullhorn data centre to the end of the URL. 

To show you what to do next, we’ll walk you through with our own example. In doing so we will use words instead of the usual number and letter codes that make up the token. This will make it a little bit easier to track each step. 

Now let’s say for arguments sake that idibu generated my ID token as MONKEYBANANA (which would be cool, but very unlikely). I firstly copy this into Notepad, then highlight > 'right click' > and 'copy' the text.

4. I then highlight the VALUE_FOR_ID text in the URL and then right click and ‘paste’

i.

ii.

5. Now, in an equally unlikely twist of fate, let’s pretend that idibu generated my SECRET token as ELEPHANTPEANUT

I simply follow the same process to replace the VALUE_FOR_SECRET text:

i.

ii.

6. All that remains now is to add the value for your allocated Bullhorn data centre at then end of the URL. In our example, I'm going to add the value 'CLS2' as shown:

7. The URL is now complete, and I can use this to create my custom idibu tab inside Bullhorn.

We used a couple of silly examples above to make it easier to distinguish where you need to copy and paste your text, and what parts of the URL to leave unchanged. 

The real ID and SECRET tokens created by your account will look quite different. So your URL will probably look something like this:

https://v3.idibu.com/c/integration/bullhornnovo/id/6014-CFABAFAAA-F8FEC4ABB-3A8E91CCC-1DADD/secret/UU16VDZJ5POAC0JRWSFBKTDIKABCDEFGHIJKLMNO/data_center/CLS2

It might look intimidating to someone seeing it for the first time, but as we’ve hopefully demonstrated above - in reality it’s just a line of text.

What happens when a user opens the idibu tab?

The URL we just created above is the basic version.  When added to Bullhorn it serves to create a unique and secure link between your idibu and Bullhorn accounts. When a user opens idibu inside Bullhorn, we link their two accounts automatically so vacancy, advert and candidate data all sync seamlessly.

What happens if a Bullhorn user does not have an idibu profile yet?

In this scenario when the user opens idibu for the first time, we’re able to extract some basic details such as their name and email, and create a unique ID that links the two accounts.

However, other details such as office address, phone number and website will still need completing on their idibu profile. They can do this themselves when they first post out an advert, but what can’t be updated dynamically this way is anything other than basic user permissions.  For access to other idibu tools you have purchased, you or another administrator will need to allocate these permissions inside their idibu user profile.

Syncing new users to a default group inside idibu

One way in which you can avoid the complications mentioned above, is to sync new users created via bullhorn directly into a default user group inside idibu.  This allows you to set the address details and permissions for that new user profile automatically. 

How to sync new users to a default group

If you would like to allocate new users to a default group in idibu, then follow these steps.

Building on the example above, let’s say I wanted to create a default group called ‘Zoo’ where all new users created via Bullhorn are pushed into.  In this group I can specify default address and company info, and can specify the universal permissions I want every user to have.

Here’s an example of the core information I’ve populated, and some extra permission I’ve allocated for every user in this group:

Having created this group, I can now command the Bullhorn and idibu integration to push newly created users into this group. This is done by simply adding the group name to the URL created earlier.

Adding the group logic to your URL

1. All we need to do is add the group name to the URL we have already created. So using our example above we simply would add “/group/Zoo” to the end of the URL:

2. In other words, to add your own group to your URL, you simply add “/group/” followed by your default group name. The key point is to ensure you use exact group name in your URL. If you are struggling for ideas as to what to call your group, then “Default” is a nice clear option.

Here’s how the URL would look with a group called “Default” added:

As per the example above, your own URL with a group titled default would look something like this:

https://v3.idibu.com/c/integration/bullhornnovo/id/6014-CFABAFAAA-F8FEC4ABB-3A8E91CCC-1DADD/secret/UU16VDZJ5POAC0JRWSFBKTDIKABCDEFGHIJKLMNO/data_center/CLS2/group/Default

Next steps:

Whichever URL option you have chosen, you are now ready to complete the set up of your Bullhorn integration.