javascript library to use the Bullhorn's REST APIs
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
test Updating Bullhorn Feb 12, 2016
.babelrc fix(Build): Babel and Rollup dependencies were out of date. Updated C… Mar 30, 2017
.esformatter Updating Bullhorn Feb 12, 2016
bower.json fix(Build): Missing External Helpers plugin Mar 31, 2017
package.json fix(Build): Missing External Helpers plugin Mar 31, 2017


BullhornJS is a micro-library that makes it easy to use the Bullhorn REST APIs in JavaScript applications. BullhornJS allows you to easily login into Bullhorn using OAuth, and to manipulate your Bullhorn data using a simple API.

This is an early version. I appreciate any feedback, comments, and help if you think this library is useful.

Key Characteristics

  • No jQuery dependency
  • Plain JavaScript
  • Works transparently in the browser
  • Simple API to manipulate data (create, update, delete, upsert)
  • CommonJS format


npm install --save @bullhorn/bullhornjs
bower install --save bullhornjs


  1. Initialize
var bullhorn = new Bullhorn({
    BhRestToken: '~BULLHORN_REST_TOKEN~',
    restUrl: '~BULLHORN_REST_URL~',
  1. Check if logged in:
        alert('Login success: ' + success);
        alert('Error: ' + error.message);
  1. Invoke a function: Search(), Query(), Entity(), Meta():
// Most functions are all fluent (ie. they return 'this')
var job = new Entity('entity/JobOrder').fields('title');
// the 'fields' function created a getter and setter for 'title'
job.title = 'My New Job';; //returns a promise
  1. Use a convenience method: CandidateSearch(), JobOrder(), ContactMeta(), etc...:
// This command creates the convenience functions
// Now you can use them
var job = new Job().fields('title'); //works the same as above
    console.log('Job Title is ', job.title);

Sample App

Check out the demo in the demo folder. To run the demo:

> git clone
> cd bullhornjs
> npm install
> npm run bundle
> npm install -g http-server
> http-server

open http://localhost:8080/demo/index.html in your browser


Because the browser should not know your CLIENT_ID or CLIENT_SECRET your will need to handle the OAuth flow separately then have the server provide the BhRestToken and restUrl to the client.


We build two versions of the source, 1) we create a bundle using rollup and 2) we compile all the sources separately with babel. All transpiled files are stored in the lib directory.

Rollup Bundle
This uses `rollup.config.js` to determine how to rollup the source. The bundle is located in `lib/bundle.js`. Configuration options are available [here]( To create a new bundle:

npm run bundle
Babel Compile
This uses `.babelrc` to determine how to babel compiles the source. The files are transpiled to the `lib/` directory. Other configuration options are available [here]( To rebuild these:

npm run compile


We use Jest to run all of our unit test. To run the tests, in the working directory:

npm test