BullhornSTAFFING API: Main Menu

API Update [posted on December 13, 2012]:

This version of the Bullhorn APIs will be deprecated and cease to function as of December 31, 2013.

All new work should be done using Bullhorn's REST or Web Services APIs. For more information please visit: http://developer.bullhorn.com/documentation

Bullhorn REST API provides a simpler and faster way for developers to build applications that interact with the Bullhorn platform and is used by Bullhorn Inc. to develop features of the Bullhorn ATS/CRM application.

Of the BullhornSTAFFING HTTP API interfaces listed below, our analysis shows that the following are most commonly used by developers:

Resume Parsing API
Published Job Data (XML)

The interface to these will continue to work as is because Bullhorn will replace the back end to use REST API. The URLs for these 2 specific APIs may change in the 2nd half of 2013; developers may require to update their applications to use the new URLs.

HTTP API Basics:

The BullhornSTAFFING HTTP API is designed to facilitate basic programatic access to a customer's Bullhorn interface.

All access and interaction with the API is controlled by 3 factors:

System Setting: A Bullhorn administrator must enable API access within a customer's account.
Private Label ID: All access will require a Bullhorn Private Label ID, which is tied to a customer's database.
API Encryption Key: This unique key provides a basic level of security when using the API. Bullhorn recommends that developers always use secure socket connections (https) to pass data to the Bullhorn API

HTTP Interfaces:

Resume Parsing API

The resume Parsing API is used to parse resumes in either text, HTML or file upload formats. An HRXML JobSeeker record is returned. This API is useful in pre-populating a candidate's apply online form with contact information.
Candidate Capture Tools

The Candidate Capture Tool allows the creation of an "apply online" form that will post directly to the Bullhorn database.
Client Capture Tools

The Client Contact Capture Tool allows the creation of a lead capture form that will post directly to the Bullhorn database.
Candidate/Contact Profile Lookup

The profile lookup API is used to lookup the ID and data of an existing candidate or client contact record within the customer's Bullhorn database.
Candidate Search

The candidate search API is used to search for candidate records within the customer's Bullhorn database.
Profile Update API

The profile update API is used to update the info of an existing candidate or client contact record within the customer's Bullhorn database.
Published Job Data (XML)

The XML job data feed is used to pull public job data from the Bullhorn database. This is typically used to feed a corporate job board.
Published Job Data (CSV)

The CSV job data feed serves exactly the same purpose as the XML job feed. It is provided in the case that developers prefer a Comma Separated Values feed to XML.
Job Response Data (XML)

The XML job response data feed is used to pull job response data from the Bullhorn database.
Client Corporation Lookup

The client corporation lookup API is used to lookup the ID and data of an existing client corporation record within the customer's Bullhorn database.
Client Corporation Add/Update API

The Client Corporation add/update API is used to add or update Client Corporationrecords within the customer's Bullhorn database.
Client Job Data (XML)

The XML job data feed is used to pull job data for a particular client or client contact from the Bullhorn database. This is typically used to create a client portal.
Job Add/Update API

The job add/update API is used to add, update or delete job records within the customer's Bullhorn database.
Get Notes

The Get Notes API is used to retreive notes from an existing candidate, client contact or job records within the customer's Bullhorn database.
Add Note API

The add note API is used to add notes to an existing candidate, client contact or job records within the customer's Bullhorn database.
File Attachment API

The File Attachment API allows the programmatic attachment of a files to a candidate or client's profile. It accepts a user ID and a file and will attach the file to the candidate or contact's record.
File Attachment List API

The File Attachment List API returns a list of a files attached to a candidate or client's profile. It accepts a user ID.
File Retrival API

The File Retrival API returns a specific file attached to a candidate or client's profile. It accepts a user ID and a file id
File Deletion API

The File Deletion API removes a specific file attached to a candidate or client's profile. It accepts a user ID and a file id
Job Application API

The Job Application API allows the programmatic creation of a job response, or application. It accepts a candidate ID or email address and a job ID and will log a response in the job activity.
Accounting Export API

The API allows multiple the retreival of Time, Invoice, Customer, Placement and Employee data to support accounting package and payroll integration.
Placement Update API

The placement update API is used to update the info of an existing placement the customer's Bullhorn database.
Contact/Candidate Mass CSV Import API

The mass import API allows multiple records to be imported into the Bullhorn database programmatically. The API takes a username, password and a CSV file and creates either client contact or candidate records with a status of "Imported". This API is useful for systems that will regularly send leads to the database.
Update Email Message API

The update email message API is used to update email messages existing email message records within the customer's Bullhorn database. This API can be used to update messages as read, deleted or flagged for follow up
Add Email Message API

The add email message API is used to create an email message within the customer's Bullhorn database. This API can be used to add activity records associated with candidates or contacts
Get Email Messages API

The get email messages API is used to get email messages within the customer's Bullhorn database for a particular user, within a particular folder.
Get Message Folders API

The get message folders API is used to get a list of the message folders within the customer's Bullhorn database for a particular user.
Add Message Folder API

The add message folder API is used to create new folders within the customer's Bullhorn database for a particular user.
Update Message Folder API

The update message folder API is used to update or delete message folders within the customer's Bullhorn database for a particular user.
Field Map API

This API can be used to retrieve field map configuration data for a particular entity type.
Template Lookup API

This API can be used to retrieve template configuration data for a particular entity type.
People Template API

This API can be used to create, read, update and delete people template data.
Corporation Template API

This API can be used to create, read, update and delete corporation template data.
Get Work History API

The Get Work History API is used to retrieve work history records within the customer's Bullhorn database.
Work History Add/Update API

The Work History add/update API is used to add, update or delete work history records within the customer's Bullhorn database.
Get Education API

The Get Education API is used to retrieve education records within the customer's Bullhorn database.
Education Add/Update API

The Education add/update API is used to add, update or delete education records within the customer's Bullhorn database.
Get Reference API

The Get Reference API is used to retrieve reference records within the customer's Bullhorn database.
Reference Add/Update API

The Reference add/update API is used to add, update or delete reference records within the customer's Bullhorn database.
Client Company File API

This API can be used to list, get, add,and remove file from a company record.
Add Timecard API

This API can be used to add timecard within the customer's Bullhorn database.
Data Export API

This API can be used run predefined custom exports against the customer's Bullhorn database.