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
| Action | What it does |
|---|---|
| Add note | Add a note to a candidate or contact, as the API user, optionally about a job. |
| Create candidate | Add a candidate to Bullhorn with their contact details, status and owner. |
| Create company | Add a client company. |
| Create contact | Add a client contact at a company, with their contact details and owner. |
| Create job | Add a job for a client contact and company, with its status, openings, start date and rates. |
| Create task | Add a task to a recruiter's list, optionally about a candidate, contact or job. |
| Delete record | Delete a candidate, contact, job, submission, note or task. |
| Get candidate | Get one candidate with their contact details, status, owner and availability. |
| Get company | Get one client company with its status, phone, website and address. |
| Get contact | Get one client contact with their company, contact details and owner. |
| Get job | Get one job with its company, hiring contact, status, rates and description. |
| Get placement | Get one placement with its candidate, job, dates and rates. |
| List notes | List the notes on a candidate or contact, or about a job, newest first. |
| List submissions | List the submissions to a job, of a candidate, or in a status, newest first. |
| Search candidates | Find candidates by name, email, status or owner, or any Lucene query. |
| Search companies | Find client companies by name or status, or any Lucene query. |
| Search contacts | Find client contacts by name, email, company, status or owner, or any Lucene query. |
| Search jobs | Find jobs by title, status, company or owner, open or not, or any Lucene query. |
| Search placements | Find placements by candidate, job or status, or any Lucene query. |
| Submit candidate to job | Submit a candidate to a job, as the API user. |
| Update candidate | Change a candidate's details, status, owner or address. |
| Update company | Change a client company's name, status, contact details or address. |
| Update contact | Change a client contact's details, company, status or owner. |
| Update job | Change a job's title, status, openings, dates, rates or owner, or open or close it. |
| Update submission | Move 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 ID
person_idtextRequired - The Bullhorn id of the candidate or contact the note is about.
- Note
commentstextRequired - The note's text.
- Action
note_actiontext - What the note records, from your Bullhorn note actions, such as Call.
- Job
job_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 name
first_nametextRequired - The candidate's first name.
- Last name
last_nametextRequired - The candidate's last name.
- Email
emailtext - The candidate's email address.
- Phone
phonetext - The candidate's phone number.
- Mobile
mobiletext - The candidate's mobile number.
- Status
statustext - One of your Bullhorn candidate statuses, such as Active or New Lead.
- Source
sourcetext - Where the candidate came from, such as LinkedIn.
- Current job title
occupationtext - Their current job title.
- Current employer
company_nametext - Their current employer.
- Owner
owner_idtext - The Bullhorn user who owns the candidate. Leave empty for the API user.
- Available from
date_availabledate and time - When the candidate can start.
- Street address
address1text - The candidate's street address.
- City
citytext - The candidate's city.
- State
statetext - The candidate's state or region, such as MA.
- Postal code
zip_codetext - The candidate's ZIP or postal code.
- Country
country_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
- Name
nametextRequired - The company's name.
- Status
statustext - One of your Bullhorn company statuses, such as Prospect or Active Account.
- Phone
phonetext - The company's main phone number.
- Website
websitetext - The company's website address.
- Description
descriptiontext - About the company.
- Street address
address1text - The company's street address.
- City
citytext - The company's city.
- State
statetext - The company's state or region, such as MA.
- Postal code
zip_codetext - The company's ZIP or postal code.
- Country
country_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 name
first_nametextRequired - The contact's first name.
- Last name
last_nametextRequired - The contact's last name.
- Company
company_idtextRequired - The company the contact works for.
- Email
emailtext - The contact's email address.
- Phone
phonetext - The contact's phone number.
- Mobile
mobiletext - The contact's mobile number.
- Job title
occupationtext - The contact's job title.
- Status
statustext - One of your Bullhorn contact statuses, such as Active.
- Owner
owner_idtext - The Bullhorn user who owns the contact. Leave empty for the API user.
- Street address
address1text - The contact's street address.
- City
citytext - The contact's city.
- State
statetext - The contact's state or region, such as MA.
- Postal code
zip_codetext - The contact's ZIP or postal code.
- Country
country_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
- Title
titletextRequired - The job's title.
- Hiring contact
contact_idtextRequired - The client contact the job is for.
- Company
company_idtextRequired - The hiring company, the contact's company.
- Status
statustext - One of your Bullhorn job statuses, such as Accepting Candidates.
- Open
is_opentext - Whether the job is open. Leave empty for Bullhorn’s default.One of:
yes,no. - Employment type
employment_typetext - One of your Bullhorn employment types, such as Contract or Direct Hire.
- Openings
num_openingsnumber - How many people are wanted.At least 1.
- Start date
start_datedate and time - When the job starts.
- Description
descriptiontext - The job description.
- Owner
owner_idtext - The Bullhorn user who owns the job. Leave empty for the API user.
- Salary
salarynumber - The salary offered.At least 0.
- Pay rate
pay_ratenumber - The pay rate, for contract jobs.At least 0.
- Bill rate
bill_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
- Subject
subjecttextRequired - What the task is.
- Due
duedate and time - When it is due. Leave empty for now.
- Description
descriptiontext - More about the task.
- Type
task_typetext - One of your Bullhorn task types, such as Call or Meeting.
- Candidate ID
candidate_idtext - The candidate it is about.
- Contact
contact_idtext - The contact it is about.
- Job
job_idtext - The job it is about.
- Assigned to
owner_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 type
record_typetextRequired - What kind of record it is.One of:
Candidate,ClientContact(Contact),JobOrder(Job),JobSubmission(Submission),Note,Task. - Record ID
record_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 ID
candidate_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
- Company
company_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
- Contact
contact_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
- Job
job_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 ID
placement_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 ID
person_idtext - Notes about this candidate or contact. Give this, a job, or both.
- Job
job_idtext - Notes about this job.
- Action
note_actiontext - Only notes with this action.
- How many
countnumber - How many to return, 1 to 500. Defaults to 20.From 1 to 500.
- Start
startnumber - 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
- Job
job_idtext - Only submissions to this job.
- Candidate ID
candidate_idtext - Only this candidate's submissions.
- Status
statustext - Only submissions in this status.
- How many
countnumber - How many to return, 1 to 500. Defaults to 20.From 1 to 500.
- Start
startnumber - 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
- Name
nametext - Only candidates with this name.
- Email
emailtext - Only candidates with this email address.
- Status
statustext - Only candidates with this status, such as Active.
- Owner
owner_idtext - Only ones this Bullhorn user owns.
- Advanced query
querytext - Any further Lucene search, added to the fields given, such as skillSet:java OR address.city:Boston.
- Order
sorttext - Which come first. Defaults to newest first.One of:
-dateAdded(Newest first),dateAdded(Oldest first),-dateLastModified(Most recently changed first). - How many
countnumber - How many to return, 1 to 500. Defaults to 20.From 1 to 500.
- Start
startnumber - 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
- Name
nametext - Only companies with this name.
- Status
statustext - Only companies with this status.
- Advanced query
querytext - Any further Lucene search, added to the fields given, such as skillSet:java OR address.city:Boston.
- Order
sorttext - Which come first. Defaults to newest first.One of:
-dateAdded(Newest first),dateAdded(Oldest first),-dateLastModified(Most recently changed first). - How many
countnumber - How many to return, 1 to 500. Defaults to 20.From 1 to 500.
- Start
startnumber - 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
- Name
nametext - Only contacts with this name.
- Email
emailtext - Only contacts with this email address.
- Company
company_idtext - Only ones at this company.
- Status
statustext - Only contacts with this status.
- Owner
owner_idtext - Only ones this Bullhorn user owns.
- Advanced query
querytext - Any further Lucene search, added to the fields given, such as skillSet:java OR address.city:Boston.
- Order
sorttext - Which come first. Defaults to newest first.One of:
-dateAdded(Newest first),dateAdded(Oldest first),-dateLastModified(Most recently changed first). - How many
countnumber - How many to return, 1 to 500. Defaults to 20.From 1 to 500.
- Start
startnumber - 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
- Title
titletext - Only jobs with this title.
- Status
statustext - Only jobs with this status.
- Open
is_opentext - Only open jobs (Yes) or closed ones (No). Leave empty for both.One of:
yes,no. - Company
company_idtext - Only ones at this company.
- Owner
owner_idtext - Only ones this Bullhorn user owns.
- Advanced query
querytext - Any further Lucene search, added to the fields given, such as skillSet:java OR address.city:Boston.
- Order
sorttext - Which come first. Defaults to newest first.One of:
-dateAdded(Newest first),dateAdded(Oldest first),-dateLastModified(Most recently changed first). - How many
countnumber - How many to return, 1 to 500. Defaults to 20.From 1 to 500.
- Start
startnumber - 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 ID
candidate_idtext - Only this candidate's placements.
- Job
job_idtext - Only placements in this job.
- Status
statustext - Only placements with this status, such as Approved.
- Advanced query
querytext - Any further Lucene search, added to the fields given, such as skillSet:java OR address.city:Boston.
- Order
sorttext - Which come first. Defaults to newest first.One of:
-dateAdded(Newest first),dateAdded(Oldest first),-dateLastModified(Most recently changed first). - How many
countnumber - How many to return, 1 to 500. Defaults to 20.From 1 to 500.
- Start
startnumber - 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 ID
candidate_idtextRequired - The candidate's Bullhorn id.
- Job
job_idtextRequired - The job. Pick one, or give its id.
- Status
statustext - One of your Bullhorn submission statuses. Defaults to Submitted; New Lead makes it a web response instead.
- Source
sourcetext - Where the submission came from.
- Comments
commentstext - 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 ID
candidate_idtextRequired - The candidate's Bullhorn id.
- First name
first_nametext - The candidate's first name. Leave empty to keep it.
- Last name
last_nametext - The candidate's last name. Leave empty to keep it.
- Email
emailtext - The candidate's email address. Leave empty to keep it.
- Phone
phonetext - The candidate's phone number. Leave empty to keep it.
- Mobile
mobiletext - The candidate's mobile number. Leave empty to keep it.
- Status
statustext - One of your Bullhorn candidate statuses, such as Active or New Lead. Leave empty to keep it.
- Source
sourcetext - Where the candidate came from, such as LinkedIn. Leave empty to keep it.
- Current job title
occupationtext - Their current job title. Leave empty to keep it.
- Current employer
company_nametext - Their current employer. Leave empty to keep it.
- Owner
owner_idtext - The Bullhorn user who owns the candidate. Leave empty to keep it.
- Available from
date_availabledate and time - When the candidate can start. Leave empty to keep it.
- Street address
address1text - The candidate's street address. Leave empty to keep it.
- City
citytext - The candidate's city. Leave empty to keep it.
- State
statetext - The candidate's state or region, such as MA. Leave empty to keep it.
- Postal code
zip_codetext - The candidate's ZIP or postal code. Leave empty to keep it.
- Country
country_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
- Company
company_idtextRequired - The company. Pick one, or give its id.
- Name
nametext - The company's name. Leave empty to keep it.
- Status
statustext - One of your Bullhorn company statuses, such as Prospect or Active Account. Leave empty to keep it.
- Phone
phonetext - The company's main phone number. Leave empty to keep it.
- Website
websitetext - The company's website address. Leave empty to keep it.
- Description
descriptiontext - About the company. Leave empty to keep it.
- Street address
address1text - The company's street address. Leave empty to keep it.
- City
citytext - The company's city. Leave empty to keep it.
- State
statetext - The company's state or region, such as MA. Leave empty to keep it.
- Postal code
zip_codetext - The company's ZIP or postal code. Leave empty to keep it.
- Country
country_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
- Contact
contact_idtextRequired - The contact. Pick one, or give their id.
- First name
first_nametext - The contact's first name. Leave empty to keep it.
- Last name
last_nametext - The contact's last name. Leave empty to keep it.
- Company
company_idtext - The company the contact works for. Leave empty to keep it.
- Email
emailtext - The contact's email address. Leave empty to keep it.
- Phone
phonetext - The contact's phone number. Leave empty to keep it.
- Mobile
mobiletext - The contact's mobile number. Leave empty to keep it.
- Job title
occupationtext - The contact's job title. Leave empty to keep it.
- Status
statustext - One of your Bullhorn contact statuses, such as Active. Leave empty to keep it.
- Owner
owner_idtext - The Bullhorn user who owns the contact. Leave empty to keep it.
- Street address
address1text - The contact's street address. Leave empty to keep it.
- City
citytext - The contact's city. Leave empty to keep it.
- State
statetext - The contact's state or region, such as MA. Leave empty to keep it.
- Postal code
zip_codetext - The contact's ZIP or postal code. Leave empty to keep it.
- Country
country_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
- Job
job_idtextRequired - The job. Pick one, or give its id.
- Title
titletext - The job's title. Leave empty to keep it.
- Hiring contact
contact_idtext - The client contact the job is for. Leave empty to keep it.
- Status
statustext - One of your Bullhorn job statuses, such as Accepting Candidates. Leave empty to keep it.
- Open
is_opentext - Whether the job is open. Leave empty to keep it.One of:
yes,no. - Employment type
employment_typetext - One of your Bullhorn employment types, such as Contract or Direct Hire. Leave empty to keep it.
- Openings
num_openingsnumber - How many people are wanted. Leave empty to keep it.At least 1.
- Start date
start_datedate and time - When the job starts. Leave empty to keep it.
- Description
descriptiontext - The job description. Leave empty to keep it.
- Owner
owner_idtext - The Bullhorn user who owns the job. Leave empty to keep it.
- Salary
salarynumber - The salary offered. Leave empty to keep it.At least 0.
- Pay rate
pay_ratenumber - The pay rate, for contract jobs. Leave empty to keep it.At least 0.
- Bill rate
bill_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 ID
submission_idtextRequired - The submission's Bullhorn id.
- Status
statustext - One of your Bullhorn submission statuses, such as Interview Scheduled. Leave empty to keep it.
- Comments
commentstext - 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"
}
}