Bullhorn

App · 25 actions

Run your staffing desk in Bullhorn: find, add and update candidates, contacts, companies and jobs, submit candidates to jobs and move them through statuses, read placements, add notes and tasks, and start workflows when records are added or change.

Actions

ActionWhat it does
Add noteAdd a note to a candidate or contact, as the API user, optionally about a job.
Create candidateAdd a candidate to Bullhorn with their contact details, status and owner.
Create companyAdd a client company.
Create contactAdd a client contact at a company, with their contact details and owner.
Create jobAdd a job for a client contact and company, with its status, openings, start date and rates.
Create taskAdd a task to a recruiter's list, optionally about a candidate, contact or job.
Delete recordDelete a candidate, contact, job, submission, note or task.
Get candidateGet one candidate with their contact details, status, owner and availability.
Get companyGet one client company with its status, phone, website and address.
Get contactGet one client contact with their company, contact details and owner.
Get jobGet one job with its company, hiring contact, status, rates and description.
Get placementGet one placement with its candidate, job, dates and rates.
List notesList the notes on a candidate or contact, or about a job, newest first.
List submissionsList the submissions to a job, of a candidate, or in a status, newest first.
Search candidatesFind candidates by name, email, status or owner, or any Lucene query.
Search companiesFind client companies by name or status, or any Lucene query.
Search contactsFind client contacts by name, email, company, status or owner, or any Lucene query.
Search jobsFind jobs by title, status, company or owner, open or not, or any Lucene query.
Search placementsFind placements by candidate, job or status, or any Lucene query.
Submit candidate to jobSubmit a candidate to a job, as the API user.
Update candidateChange a candidate's details, status, owner or address.
Update companyChange a client company's name, status, contact details or address.
Update contactChange a client contact's details, company, status or owner.
Update jobChange a job's title, status, openings, dates, rates or owner, or open or close it.
Update submissionMove a submission to another status, such as Interview Scheduled, or change its comments.

Add note

Add a note to a candidate or contact, as the API user, optionally about a job.

Inputs

Candidate or contact IDperson_idtextRequired
The Bullhorn id of the candidate or contact the note is about.
NotecommentstextRequired
The note's text.
Actionnote_actiontext
What the note records, from your Bullhorn note actions, such as Call.
Jobjob_idtext
The job the note is about, if any.

Outputs

noteobject
The note
Example output
{
  "note": {
    "action": "Call",
    "commentingPerson": {
      "firstName": "Alex",
      "id": 7,
      "lastName": "Recruiter"
    },
    "comments": "Spoke about the Senior Accountant role.",
    "dateAdded": 1763020800000,
    "id": 2552,
    "jobOrder": {
      "id": 4401,
      "title": "Senior Accountant"
    },
    "personReference": {
      "firstName": "Jo",
      "id": 5059165,
      "lastName": "Bloggs"
    }
  }
}

Create candidate

Add a candidate to Bullhorn with their contact details, status and owner.

Inputs

First namefirst_nametextRequired
The candidate's first name.
Last namelast_nametextRequired
The candidate's last name.
Emailemailtext
The candidate's email address.
Phonephonetext
The candidate's phone number.
Mobilemobiletext
The candidate's mobile number.
Statusstatustext
One of your Bullhorn candidate statuses, such as Active or New Lead.
Sourcesourcetext
Where the candidate came from, such as LinkedIn.
Current job titleoccupationtext
Their current job title.
Current employercompany_nametext
Their current employer.
Ownerowner_idtext
The Bullhorn user who owns the candidate. Leave empty for the API user.
Available fromdate_availabledate and time
When the candidate can start.
Street addressaddress1text
The candidate's street address.
Citycitytext
The candidate's city.
Statestatetext
The candidate's state or region, such as MA.
Postal codezip_codetext
The candidate's ZIP or postal code.
Countrycountry_idtext
The candidate's country.

Outputs

candidateobject
The candidate
Example output
{
  "candidate": {
    "address": {
      "address1": "100 Summer Street",
      "address2": "",
      "city": "Boston",
      "countryID": 1,
      "state": "MA",
      "zip": "02110"
    },
    "companyName": "Example Co",
    "dateAdded": 1763020800000,
    "dateAvailable": 1767225600000,
    "dateLastModified": 1763024400000,
    "email": "jo@example.com",
    "firstName": "Jo",
    "id": 5059165,
    "lastName": "Bloggs",
    "mobile": "617-555-0101",
    "name": "Jo Bloggs",
    "occupation": "Accountant",
    "owner": {
      "firstName": "Alex",
      "id": 7,
      "lastName": "Recruiter"
    },
    "phone": "617-555-0100",
    "source": "LinkedIn",
    "status": "Active"
  }
}

Create company

Add a client company. Bullhorn can't delete companies, so check it isn't there first.

Inputs

NamenametextRequired
The company's name.
Statusstatustext
One of your Bullhorn company statuses, such as Prospect or Active Account.
Phonephonetext
The company's main phone number.
Websitewebsitetext
The company's website address.
Descriptiondescriptiontext
About the company.
Street addressaddress1text
The company's street address.
Citycitytext
The company's city.
Statestatetext
The company's state or region, such as MA.
Postal codezip_codetext
The company's ZIP or postal code.
Countrycountry_idtext
The company's country.

Outputs

companyobject
The company
Example output
{
  "company": {
    "address": {
      "address1": "100 Summer Street",
      "address2": "",
      "city": "Boston",
      "countryID": 1,
      "state": "MA",
      "zip": "02110"
    },
    "companyDescription": "A client company.",
    "companyURL": "https://example.com",
    "dateAdded": 1763020800000,
    "dateLastModified": 1763024400000,
    "id": 301,
    "name": "Example Co",
    "phone": "617-555-0300",
    "status": "Active Account"
  }
}

Create contact

Add a client contact at a company, with their contact details and owner.

Inputs

First namefirst_nametextRequired
The contact's first name.
Last namelast_nametextRequired
The contact's last name.
Companycompany_idtextRequired
The company the contact works for.
Emailemailtext
The contact's email address.
Phonephonetext
The contact's phone number.
Mobilemobiletext
The contact's mobile number.
Job titleoccupationtext
The contact's job title.
Statusstatustext
One of your Bullhorn contact statuses, such as Active.
Ownerowner_idtext
The Bullhorn user who owns the contact. Leave empty for the API user.
Street addressaddress1text
The contact's street address.
Citycitytext
The contact's city.
Statestatetext
The contact's state or region, such as MA.
Postal codezip_codetext
The contact's ZIP or postal code.
Countrycountry_idtext
The contact's country.

Outputs

contactobject
The contact
Example output
{
  "contact": {
    "address": {
      "address1": "100 Summer Street",
      "address2": "",
      "city": "Boston",
      "countryID": 1,
      "state": "MA",
      "zip": "02110"
    },
    "clientCorporation": {
      "id": 301,
      "name": "Example Co"
    },
    "dateAdded": 1763020800000,
    "dateLastModified": 1763024400000,
    "email": "sam@example.com",
    "firstName": "Sam",
    "id": 8592,
    "lastName": "Lee",
    "mobile": "617-555-0201",
    "name": "Sam Lee",
    "occupation": "Finance Director",
    "owner": {
      "firstName": "Alex",
      "id": 7,
      "lastName": "Recruiter"
    },
    "phone": "617-555-0200",
    "status": "Active"
  }
}

Create job

Add a job for a client contact and company, with its status, openings, start date and rates.

Inputs

TitletitletextRequired
The job's title.
Hiring contactcontact_idtextRequired
The client contact the job is for.
Companycompany_idtextRequired
The hiring company, the contact's company.
Statusstatustext
One of your Bullhorn job statuses, such as Accepting Candidates.
Openis_opentext
Whether the job is open. Leave empty for Bullhorn’s default.One of: yes, no.
Employment typeemployment_typetext
One of your Bullhorn employment types, such as Contract or Direct Hire.
Openingsnum_openingsnumber
How many people are wanted.At least 1.
Start datestart_datedate and time
When the job starts.
Descriptiondescriptiontext
The job description.
Ownerowner_idtext
The Bullhorn user who owns the job. Leave empty for the API user.
Salarysalarynumber
The salary offered.At least 0.
Pay ratepay_ratenumber
The pay rate, for contract jobs.At least 0.
Bill ratebill_ratenumber
The rate billed to the client.At least 0.

Outputs

jobobject
The job
Example output
{
  "job": {
    "address": {
      "address1": "100 Summer Street",
      "address2": "",
      "city": "Boston",
      "countryID": 1,
      "state": "MA",
      "zip": "02110"
    },
    "clientBillRate": 0,
    "clientContact": {
      "firstName": "Sam",
      "id": 8592,
      "lastName": "Lee"
    },
    "clientCorporation": {
      "id": 301,
      "name": "Example Co"
    },
    "dateAdded": 1763020800000,
    "dateLastModified": 1763024400000,
    "description": "Lead month-end close.",
    "employmentType": "Direct Hire",
    "id": 4401,
    "isOpen": true,
    "numOpenings": 1,
    "owner": {
      "firstName": "Alex",
      "id": 7,
      "lastName": "Recruiter"
    },
    "payRate": 0,
    "salary": 85000,
    "startDate": 1767225600000,
    "status": "Accepting Candidates",
    "title": "Senior Accountant"
  }
}

Create task

Add a task to a recruiter's list, optionally about a candidate, contact or job.

Inputs

SubjectsubjecttextRequired
What the task is.
Dueduedate and time
When it is due. Leave empty for now.
Descriptiondescriptiontext
More about the task.
Typetask_typetext
One of your Bullhorn task types, such as Call or Meeting.
Candidate IDcandidate_idtext
The candidate it is about.
Contactcontact_idtext
The contact it is about.
Jobjob_idtext
The job it is about.
Assigned toowner_idtext
The Bullhorn user it is for. Leave empty for the API user.

Outputs

taskobject
The task
Example output
{
  "task": {
    "candidate": {
      "firstName": "Jo",
      "id": 5059165,
      "lastName": "Bloggs"
    },
    "clientContact": null,
    "dateAdded": 1763020800000,
    "dateBegin": 1763107200000,
    "dateEnd": 1763107200000,
    "description": "Ask about notice period.",
    "id": 3301,
    "isCompleted": false,
    "jobOrder": {
      "id": 4401,
      "title": "Senior Accountant"
    },
    "owner": {
      "firstName": "Alex",
      "id": 7,
      "lastName": "Recruiter"
    },
    "subject": "Follow up with Jo",
    "type": "Call"
  }
}

Delete record

Delete a candidate, contact, job, submission, note or task. Bullhorn marks it deleted and hides it; an admin can still restore it.

Inputs

Record typerecord_typetextRequired
What kind of record it is.One of: Candidate, ClientContact (Contact), JobOrder (Job), JobSubmission (Submission), Note, Task.
Record IDrecord_idtextRequired
The record's Bullhorn id.

Outputs

deletedtrue/false
True once Bullhorn deleted it
idnumber
The deleted record's id
record_typetext
The kind of record deleted
Example output
{
  "deleted": true,
  "id": 2552,
  "record_type": "Note"
}

Get candidate

Get one candidate with their contact details, status, owner and availability.

Inputs

Candidate IDcandidate_idtextRequired
The candidate's Bullhorn id.

Outputs

candidateobject
The candidate
Example output
{
  "candidate": {
    "address": {
      "address1": "100 Summer Street",
      "address2": "",
      "city": "Boston",
      "countryID": 1,
      "state": "MA",
      "zip": "02110"
    },
    "companyName": "Example Co",
    "dateAdded": 1763020800000,
    "dateAvailable": 1767225600000,
    "dateLastModified": 1763024400000,
    "email": "jo@example.com",
    "firstName": "Jo",
    "id": 5059165,
    "lastName": "Bloggs",
    "mobile": "617-555-0101",
    "name": "Jo Bloggs",
    "occupation": "Accountant",
    "owner": {
      "firstName": "Alex",
      "id": 7,
      "lastName": "Recruiter"
    },
    "phone": "617-555-0100",
    "source": "LinkedIn",
    "status": "Active"
  }
}

Get company

Get one client company with its status, phone, website and address.

Inputs

Companycompany_idtextRequired
The company. Pick one, or give its id.

Outputs

companyobject
The company
Example output
{
  "company": {
    "address": {
      "address1": "100 Summer Street",
      "address2": "",
      "city": "Boston",
      "countryID": 1,
      "state": "MA",
      "zip": "02110"
    },
    "companyDescription": "A client company.",
    "companyURL": "https://example.com",
    "dateAdded": 1763020800000,
    "dateLastModified": 1763024400000,
    "id": 301,
    "name": "Example Co",
    "phone": "617-555-0300",
    "status": "Active Account"
  }
}

Get contact

Get one client contact with their company, contact details and owner.

Inputs

Contactcontact_idtextRequired
The contact. Pick one, or give their id.

Outputs

contactobject
The contact
Example output
{
  "contact": {
    "address": {
      "address1": "100 Summer Street",
      "address2": "",
      "city": "Boston",
      "countryID": 1,
      "state": "MA",
      "zip": "02110"
    },
    "clientCorporation": {
      "id": 301,
      "name": "Example Co"
    },
    "dateAdded": 1763020800000,
    "dateLastModified": 1763024400000,
    "email": "sam@example.com",
    "firstName": "Sam",
    "id": 8592,
    "lastName": "Lee",
    "mobile": "617-555-0201",
    "name": "Sam Lee",
    "occupation": "Finance Director",
    "owner": {
      "firstName": "Alex",
      "id": 7,
      "lastName": "Recruiter"
    },
    "phone": "617-555-0200",
    "status": "Active"
  }
}

Get job

Get one job with its company, hiring contact, status, rates and description.

Inputs

Jobjob_idtextRequired
The job. Pick one, or give its id.

Outputs

jobobject
The job
Example output
{
  "job": {
    "address": {
      "address1": "100 Summer Street",
      "address2": "",
      "city": "Boston",
      "countryID": 1,
      "state": "MA",
      "zip": "02110"
    },
    "clientBillRate": 0,
    "clientContact": {
      "firstName": "Sam",
      "id": 8592,
      "lastName": "Lee"
    },
    "clientCorporation": {
      "id": 301,
      "name": "Example Co"
    },
    "dateAdded": 1763020800000,
    "dateLastModified": 1763024400000,
    "description": "Lead month-end close.",
    "employmentType": "Direct Hire",
    "id": 4401,
    "isOpen": true,
    "numOpenings": 1,
    "owner": {
      "firstName": "Alex",
      "id": 7,
      "lastName": "Recruiter"
    },
    "payRate": 0,
    "salary": 85000,
    "startDate": 1767225600000,
    "status": "Accepting Candidates",
    "title": "Senior Accountant"
  }
}

Get placement

Get one placement with its candidate, job, dates and rates.

Inputs

Placement IDplacement_idtextRequired
The placement's Bullhorn id.

Outputs

placementobject
The placement
Example output
{
  "placement": {
    "candidate": {
      "firstName": "Jo",
      "id": 5059165,
      "lastName": "Bloggs"
    },
    "clientBillRate": 0,
    "dateAdded": 1763020800000,
    "dateBegin": 1767225600000,
    "dateEnd": null,
    "dateLastModified": 1763024400000,
    "employmentType": "Direct Hire",
    "id": 7701,
    "jobOrder": {
      "id": 4401,
      "title": "Senior Accountant"
    },
    "owner": {
      "firstName": "Alex",
      "id": 7,
      "lastName": "Recruiter"
    },
    "payRate": 0,
    "salary": 85000,
    "salaryUnit": "Yearly",
    "status": "Approved"
  }
}

List notes

List the notes on a candidate or contact, or about a job, newest first. Gets one page; to see more, run it again with the next start it gives.

Inputs

Candidate or contact IDperson_idtext
Notes about this candidate or contact. Give this, a job, or both.
Jobjob_idtext
Notes about this job.
Actionnote_actiontext
Only notes with this action.
How manycountnumber
How many to return, 1 to 500. Defaults to 20.From 1 to 500.
Startstartnumber
Where to start, from 0. Use the 'next_start' an earlier run gave.At least 0.

Outputs

next_startnumber
The Start to give for the next page; 0 when this is the last
noteslist
The notes
totalnumber
How many match in all (for submissions and notes, how many were read)
Example output
{
  "next_start": 0,
  "notes": [
    {
      "action": "Call",
      "commentingPerson": {
        "firstName": "Alex",
        "id": 7,
        "lastName": "Recruiter"
      },
      "comments": "Spoke about the Senior Accountant role.",
      "dateAdded": 1763020800000,
      "id": 2552,
      "jobOrder": {
        "id": 4401,
        "title": "Senior Accountant"
      },
      "personReference": {
        "firstName": "Jo",
        "id": 5059165,
        "lastName": "Bloggs"
      }
    }
  ],
  "total": 1
}

List submissions

List the submissions to a job, of a candidate, or in a status, newest first. Gets one page; to see more, run it again with the next start it gives.

Inputs

Jobjob_idtext
Only submissions to this job.
Candidate IDcandidate_idtext
Only this candidate's submissions.
Statusstatustext
Only submissions in this status.
How manycountnumber
How many to return, 1 to 500. Defaults to 20.From 1 to 500.
Startstartnumber
Where to start, from 0. Use the 'next_start' an earlier run gave.At least 0.

Outputs

next_startnumber
The Start to give for the next page; 0 when this is the last
submissionslist
The submissions
totalnumber
How many match in all (for submissions and notes, how many were read)
Example output
{
  "next_start": 0,
  "submissions": [
    {
      "candidate": {
        "firstName": "Jo",
        "id": 5059165,
        "lastName": "Bloggs"
      },
      "comments": "Strong match.",
      "dateAdded": 1763020800000,
      "dateLastModified": 1763024400000,
      "dateWebResponse": 1763020800000,
      "id": 9901,
      "jobOrder": {
        "id": 4401,
        "title": "Senior Accountant"
      },
      "sendingUser": {
        "firstName": "Alex",
        "id": 7,
        "lastName": "Recruiter"
      },
      "source": "Lodol",
      "status": "Submitted"
    }
  ],
  "total": 1
}

Search candidates

Find candidates by name, email, status or owner, or any Lucene query. Gets one page; to see more, run it again with the next start it gives.

Inputs

Namenametext
Only candidates with this name.
Emailemailtext
Only candidates with this email address.
Statusstatustext
Only candidates with this status, such as Active.
Ownerowner_idtext
Only ones this Bullhorn user owns.
Advanced queryquerytext
Any further Lucene search, added to the fields given, such as skillSet:java OR address.city:Boston.
Ordersorttext
Which come first. Defaults to newest first.One of: -dateAdded (Newest first), dateAdded (Oldest first), -dateLastModified (Most recently changed first).
How manycountnumber
How many to return, 1 to 500. Defaults to 20.From 1 to 500.
Startstartnumber
Where to start, from 0. Use the 'next_start' an earlier run gave.At least 0.

Outputs

candidateslist
The candidates
next_startnumber
The Start to give for the next page; 0 when this is the last
totalnumber
How many match in all (for submissions and notes, how many were read)
Example output
{
  "candidates": [
    {
      "address": {
        "address1": "100 Summer Street",
        "address2": "",
        "city": "Boston",
        "countryID": 1,
        "state": "MA",
        "zip": "02110"
      },
      "companyName": "Example Co",
      "dateAdded": 1763020800000,
      "dateAvailable": 1767225600000,
      "dateLastModified": 1763024400000,
      "email": "jo@example.com",
      "firstName": "Jo",
      "id": 5059165,
      "lastName": "Bloggs",
      "mobile": "617-555-0101",
      "name": "Jo Bloggs",
      "occupation": "Accountant",
      "owner": {
        "firstName": "Alex",
        "id": 7,
        "lastName": "Recruiter"
      },
      "phone": "617-555-0100",
      "source": "LinkedIn",
      "status": "Active"
    }
  ],
  "next_start": 0,
  "total": 1
}

Search companies

Find client companies by name or status, or any Lucene query. Gets one page; to see more, run it again with the next start it gives.

Inputs

Namenametext
Only companies with this name.
Statusstatustext
Only companies with this status.
Advanced queryquerytext
Any further Lucene search, added to the fields given, such as skillSet:java OR address.city:Boston.
Ordersorttext
Which come first. Defaults to newest first.One of: -dateAdded (Newest first), dateAdded (Oldest first), -dateLastModified (Most recently changed first).
How manycountnumber
How many to return, 1 to 500. Defaults to 20.From 1 to 500.
Startstartnumber
Where to start, from 0. Use the 'next_start' an earlier run gave.At least 0.

Outputs

companieslist
The companies
next_startnumber
The Start to give for the next page; 0 when this is the last
totalnumber
How many match in all (for submissions and notes, how many were read)
Example output
{
  "companies": [
    {
      "address": {
        "address1": "100 Summer Street",
        "address2": "",
        "city": "Boston",
        "countryID": 1,
        "state": "MA",
        "zip": "02110"
      },
      "companyDescription": "A client company.",
      "companyURL": "https://example.com",
      "dateAdded": 1763020800000,
      "dateLastModified": 1763024400000,
      "id": 301,
      "name": "Example Co",
      "phone": "617-555-0300",
      "status": "Active Account"
    }
  ],
  "next_start": 0,
  "total": 1
}

Search contacts

Find client contacts by name, email, company, status or owner, or any Lucene query. Gets one page; to see more, run it again with the next start it gives.

Inputs

Namenametext
Only contacts with this name.
Emailemailtext
Only contacts with this email address.
Companycompany_idtext
Only ones at this company.
Statusstatustext
Only contacts with this status.
Ownerowner_idtext
Only ones this Bullhorn user owns.
Advanced queryquerytext
Any further Lucene search, added to the fields given, such as skillSet:java OR address.city:Boston.
Ordersorttext
Which come first. Defaults to newest first.One of: -dateAdded (Newest first), dateAdded (Oldest first), -dateLastModified (Most recently changed first).
How manycountnumber
How many to return, 1 to 500. Defaults to 20.From 1 to 500.
Startstartnumber
Where to start, from 0. Use the 'next_start' an earlier run gave.At least 0.

Outputs

contactslist
The contacts
next_startnumber
The Start to give for the next page; 0 when this is the last
totalnumber
How many match in all (for submissions and notes, how many were read)
Example output
{
  "contacts": [
    {
      "address": {
        "address1": "100 Summer Street",
        "address2": "",
        "city": "Boston",
        "countryID": 1,
        "state": "MA",
        "zip": "02110"
      },
      "clientCorporation": {
        "id": 301,
        "name": "Example Co"
      },
      "dateAdded": 1763020800000,
      "dateLastModified": 1763024400000,
      "email": "sam@example.com",
      "firstName": "Sam",
      "id": 8592,
      "lastName": "Lee",
      "mobile": "617-555-0201",
      "name": "Sam Lee",
      "occupation": "Finance Director",
      "owner": {
        "firstName": "Alex",
        "id": 7,
        "lastName": "Recruiter"
      },
      "phone": "617-555-0200",
      "status": "Active"
    }
  ],
  "next_start": 0,
  "total": 1
}

Search jobs

Find jobs by title, status, company or owner, open or not, or any Lucene query. Gets one page; to see more, run it again with the next start it gives.

Inputs

Titletitletext
Only jobs with this title.
Statusstatustext
Only jobs with this status.
Openis_opentext
Only open jobs (Yes) or closed ones (No). Leave empty for both.One of: yes, no.
Companycompany_idtext
Only ones at this company.
Ownerowner_idtext
Only ones this Bullhorn user owns.
Advanced queryquerytext
Any further Lucene search, added to the fields given, such as skillSet:java OR address.city:Boston.
Ordersorttext
Which come first. Defaults to newest first.One of: -dateAdded (Newest first), dateAdded (Oldest first), -dateLastModified (Most recently changed first).
How manycountnumber
How many to return, 1 to 500. Defaults to 20.From 1 to 500.
Startstartnumber
Where to start, from 0. Use the 'next_start' an earlier run gave.At least 0.

Outputs

jobslist
The jobs
next_startnumber
The Start to give for the next page; 0 when this is the last
totalnumber
How many match in all (for submissions and notes, how many were read)
Example output
{
  "jobs": [
    {
      "address": {
        "address1": "100 Summer Street",
        "address2": "",
        "city": "Boston",
        "countryID": 1,
        "state": "MA",
        "zip": "02110"
      },
      "clientBillRate": 0,
      "clientContact": {
        "firstName": "Sam",
        "id": 8592,
        "lastName": "Lee"
      },
      "clientCorporation": {
        "id": 301,
        "name": "Example Co"
      },
      "dateAdded": 1763020800000,
      "dateLastModified": 1763024400000,
      "description": "Lead month-end close.",
      "employmentType": "Direct Hire",
      "id": 4401,
      "isOpen": true,
      "numOpenings": 1,
      "owner": {
        "firstName": "Alex",
        "id": 7,
        "lastName": "Recruiter"
      },
      "payRate": 0,
      "salary": 85000,
      "startDate": 1767225600000,
      "status": "Accepting Candidates",
      "title": "Senior Accountant"
    }
  ],
  "next_start": 0,
  "total": 1
}

Search placements

Find placements by candidate, job or status, or any Lucene query. Gets one page; to see more, run it again with the next start it gives.

Inputs

Candidate IDcandidate_idtext
Only this candidate's placements.
Jobjob_idtext
Only placements in this job.
Statusstatustext
Only placements with this status, such as Approved.
Advanced queryquerytext
Any further Lucene search, added to the fields given, such as skillSet:java OR address.city:Boston.
Ordersorttext
Which come first. Defaults to newest first.One of: -dateAdded (Newest first), dateAdded (Oldest first), -dateLastModified (Most recently changed first).
How manycountnumber
How many to return, 1 to 500. Defaults to 20.From 1 to 500.
Startstartnumber
Where to start, from 0. Use the 'next_start' an earlier run gave.At least 0.

Outputs

next_startnumber
The Start to give for the next page; 0 when this is the last
placementslist
The placements
totalnumber
How many match in all (for submissions and notes, how many were read)
Example output
{
  "next_start": 0,
  "placements": [
    {
      "candidate": {
        "firstName": "Jo",
        "id": 5059165,
        "lastName": "Bloggs"
      },
      "clientBillRate": 0,
      "dateAdded": 1763020800000,
      "dateBegin": 1767225600000,
      "dateEnd": null,
      "dateLastModified": 1763024400000,
      "employmentType": "Direct Hire",
      "id": 7701,
      "jobOrder": {
        "id": 4401,
        "title": "Senior Accountant"
      },
      "owner": {
        "firstName": "Alex",
        "id": 7,
        "lastName": "Recruiter"
      },
      "payRate": 0,
      "salary": 85000,
      "salaryUnit": "Yearly",
      "status": "Approved"
    }
  ],
  "total": 1
}

Submit candidate to job

Submit a candidate to a job, as the API user. The candidate then shows in the job's pipeline.

Inputs

Candidate IDcandidate_idtextRequired
The candidate's Bullhorn id.
Jobjob_idtextRequired
The job. Pick one, or give its id.
Statusstatustext
One of your Bullhorn submission statuses. Defaults to Submitted; New Lead makes it a web response instead.
Sourcesourcetext
Where the submission came from.
Commentscommentstext
Comments on the submission.

Outputs

submissionobject
The submission
Example output
{
  "submission": {
    "candidate": {
      "firstName": "Jo",
      "id": 5059165,
      "lastName": "Bloggs"
    },
    "comments": "Strong match.",
    "dateAdded": 1763020800000,
    "dateLastModified": 1763024400000,
    "dateWebResponse": 1763020800000,
    "id": 9901,
    "jobOrder": {
      "id": 4401,
      "title": "Senior Accountant"
    },
    "sendingUser": {
      "firstName": "Alex",
      "id": 7,
      "lastName": "Recruiter"
    },
    "source": "Lodol",
    "status": "Submitted"
  }
}

Update candidate

Change a candidate's details, status, owner or address. Fields left empty stay as they are.

Inputs

Candidate IDcandidate_idtextRequired
The candidate's Bullhorn id.
First namefirst_nametext
The candidate's first name. Leave empty to keep it.
Last namelast_nametext
The candidate's last name. Leave empty to keep it.
Emailemailtext
The candidate's email address. Leave empty to keep it.
Phonephonetext
The candidate's phone number. Leave empty to keep it.
Mobilemobiletext
The candidate's mobile number. Leave empty to keep it.
Statusstatustext
One of your Bullhorn candidate statuses, such as Active or New Lead. Leave empty to keep it.
Sourcesourcetext
Where the candidate came from, such as LinkedIn. Leave empty to keep it.
Current job titleoccupationtext
Their current job title. Leave empty to keep it.
Current employercompany_nametext
Their current employer. Leave empty to keep it.
Ownerowner_idtext
The Bullhorn user who owns the candidate. Leave empty to keep it.
Available fromdate_availabledate and time
When the candidate can start. Leave empty to keep it.
Street addressaddress1text
The candidate's street address. Leave empty to keep it.
Citycitytext
The candidate's city. Leave empty to keep it.
Statestatetext
The candidate's state or region, such as MA. Leave empty to keep it.
Postal codezip_codetext
The candidate's ZIP or postal code. Leave empty to keep it.
Countrycountry_idtext
The candidate's country. Leave empty to keep it.

Outputs

candidateobject
The candidate
Example output
{
  "candidate": {
    "address": {
      "address1": "100 Summer Street",
      "address2": "",
      "city": "Boston",
      "countryID": 1,
      "state": "MA",
      "zip": "02110"
    },
    "companyName": "Example Co",
    "dateAdded": 1763020800000,
    "dateAvailable": 1767225600000,
    "dateLastModified": 1763024400000,
    "email": "jo@example.com",
    "firstName": "Jo",
    "id": 5059165,
    "lastName": "Bloggs",
    "mobile": "617-555-0101",
    "name": "Jo Bloggs",
    "occupation": "Accountant",
    "owner": {
      "firstName": "Alex",
      "id": 7,
      "lastName": "Recruiter"
    },
    "phone": "617-555-0100",
    "source": "LinkedIn",
    "status": "Active"
  }
}

Update company

Change a client company's name, status, contact details or address. Fields left empty stay as they are.

Inputs

Companycompany_idtextRequired
The company. Pick one, or give its id.
Namenametext
The company's name. Leave empty to keep it.
Statusstatustext
One of your Bullhorn company statuses, such as Prospect or Active Account. Leave empty to keep it.
Phonephonetext
The company's main phone number. Leave empty to keep it.
Websitewebsitetext
The company's website address. Leave empty to keep it.
Descriptiondescriptiontext
About the company. Leave empty to keep it.
Street addressaddress1text
The company's street address. Leave empty to keep it.
Citycitytext
The company's city. Leave empty to keep it.
Statestatetext
The company's state or region, such as MA. Leave empty to keep it.
Postal codezip_codetext
The company's ZIP or postal code. Leave empty to keep it.
Countrycountry_idtext
The company's country. Leave empty to keep it.

Outputs

companyobject
The company
Example output
{
  "company": {
    "address": {
      "address1": "100 Summer Street",
      "address2": "",
      "city": "Boston",
      "countryID": 1,
      "state": "MA",
      "zip": "02110"
    },
    "companyDescription": "A client company.",
    "companyURL": "https://example.com",
    "dateAdded": 1763020800000,
    "dateLastModified": 1763024400000,
    "id": 301,
    "name": "Example Co",
    "phone": "617-555-0300",
    "status": "Active Account"
  }
}

Update contact

Change a client contact's details, company, status or owner. Fields left empty stay as they are.

Inputs

Contactcontact_idtextRequired
The contact. Pick one, or give their id.
First namefirst_nametext
The contact's first name. Leave empty to keep it.
Last namelast_nametext
The contact's last name. Leave empty to keep it.
Companycompany_idtext
The company the contact works for. Leave empty to keep it.
Emailemailtext
The contact's email address. Leave empty to keep it.
Phonephonetext
The contact's phone number. Leave empty to keep it.
Mobilemobiletext
The contact's mobile number. Leave empty to keep it.
Job titleoccupationtext
The contact's job title. Leave empty to keep it.
Statusstatustext
One of your Bullhorn contact statuses, such as Active. Leave empty to keep it.
Ownerowner_idtext
The Bullhorn user who owns the contact. Leave empty to keep it.
Street addressaddress1text
The contact's street address. Leave empty to keep it.
Citycitytext
The contact's city. Leave empty to keep it.
Statestatetext
The contact's state or region, such as MA. Leave empty to keep it.
Postal codezip_codetext
The contact's ZIP or postal code. Leave empty to keep it.
Countrycountry_idtext
The contact's country. Leave empty to keep it.

Outputs

contactobject
The contact
Example output
{
  "contact": {
    "address": {
      "address1": "100 Summer Street",
      "address2": "",
      "city": "Boston",
      "countryID": 1,
      "state": "MA",
      "zip": "02110"
    },
    "clientCorporation": {
      "id": 301,
      "name": "Example Co"
    },
    "dateAdded": 1763020800000,
    "dateLastModified": 1763024400000,
    "email": "sam@example.com",
    "firstName": "Sam",
    "id": 8592,
    "lastName": "Lee",
    "mobile": "617-555-0201",
    "name": "Sam Lee",
    "occupation": "Finance Director",
    "owner": {
      "firstName": "Alex",
      "id": 7,
      "lastName": "Recruiter"
    },
    "phone": "617-555-0200",
    "status": "Active"
  }
}

Update job

Change a job's title, status, openings, dates, rates or owner, or open or close it. Fields left empty stay as they are.

Inputs

Jobjob_idtextRequired
The job. Pick one, or give its id.
Titletitletext
The job's title. Leave empty to keep it.
Hiring contactcontact_idtext
The client contact the job is for. Leave empty to keep it.
Statusstatustext
One of your Bullhorn job statuses, such as Accepting Candidates. Leave empty to keep it.
Openis_opentext
Whether the job is open. Leave empty to keep it.One of: yes, no.
Employment typeemployment_typetext
One of your Bullhorn employment types, such as Contract or Direct Hire. Leave empty to keep it.
Openingsnum_openingsnumber
How many people are wanted. Leave empty to keep it.At least 1.
Start datestart_datedate and time
When the job starts. Leave empty to keep it.
Descriptiondescriptiontext
The job description. Leave empty to keep it.
Ownerowner_idtext
The Bullhorn user who owns the job. Leave empty to keep it.
Salarysalarynumber
The salary offered. Leave empty to keep it.At least 0.
Pay ratepay_ratenumber
The pay rate, for contract jobs. Leave empty to keep it.At least 0.
Bill ratebill_ratenumber
The rate billed to the client. Leave empty to keep it.At least 0.

Outputs

jobobject
The job
Example output
{
  "job": {
    "address": {
      "address1": "100 Summer Street",
      "address2": "",
      "city": "Boston",
      "countryID": 1,
      "state": "MA",
      "zip": "02110"
    },
    "clientBillRate": 0,
    "clientContact": {
      "firstName": "Sam",
      "id": 8592,
      "lastName": "Lee"
    },
    "clientCorporation": {
      "id": 301,
      "name": "Example Co"
    },
    "dateAdded": 1763020800000,
    "dateLastModified": 1763024400000,
    "description": "Lead month-end close.",
    "employmentType": "Direct Hire",
    "id": 4401,
    "isOpen": true,
    "numOpenings": 1,
    "owner": {
      "firstName": "Alex",
      "id": 7,
      "lastName": "Recruiter"
    },
    "payRate": 0,
    "salary": 85000,
    "startDate": 1767225600000,
    "status": "Accepting Candidates",
    "title": "Senior Accountant"
  }
}

Update submission

Move a submission to another status, such as Interview Scheduled, or change its comments.

Inputs

Submission IDsubmission_idtextRequired
The submission's Bullhorn id.
Statusstatustext
One of your Bullhorn submission statuses, such as Interview Scheduled. Leave empty to keep it.
Commentscommentstext
New comments. Leave empty to keep them.

Outputs

submissionobject
The submission
Example output
{
  "submission": {
    "candidate": {
      "firstName": "Jo",
      "id": 5059165,
      "lastName": "Bloggs"
    },
    "comments": "Strong match.",
    "dateAdded": 1763020800000,
    "dateLastModified": 1763024400000,
    "dateWebResponse": 1763020800000,
    "id": 9901,
    "jobOrder": {
      "id": 4401,
      "title": "Senior Accountant"
    },
    "sendingUser": {
      "firstName": "Alex",
      "id": 7,
      "lastName": "Recruiter"
    },
    "source": "Lodol",
    "status": "Submitted"
  }
}

On this page