Bullhorn connector icon

Bullhorn Connector

Build in-app recruitment automations that create and update Candidates, JobOrders, Placements and Notes, parse resumes and route submissions — all embedded inside your SaaS product for customer-facing workflows.

01

Automate candidate intake

Turn applicant forms into Bullhorn Candidate records automatically.

02

Keep jobs in sync

Publish and update JobOrders across channels and sites in real time.

03

Event-driven workflows

Subscribe and poll Bullhorn events to trigger downstream automations.

04

Embedded experience

Deliver customer-facing workflows natively inside your SaaS product.

CONNECTOR OVERVIEW

Overview

Teams can integrate and automate Bullhorn staffing objects such as Candidates, JobOrders, ClientCorporations, Placements and Notes for candidate intake, job publishing, submissions and recruitment workflows. Use Cyclr to orchestrate CRUD, search and query calls, manage event subscriptions for change feeds, and map data between Bullhorn and other SaaS systems.

PRODUCT USE CASES

Use-case introduction

Practical multi-tenant integration examples for recruiting SaaS: create candidates from job forms, publish jobs to public feeds, sync placements and drive automated outreach based on Bullhorn events.

Create candidates from public application forms

Map form fields and resume text to Candidate; call PUT /entity/Candidate and parse resumes with Bullhorn parsing operations.

Publish jobs to client-facing job boards

Use JobOrder and Public API search to publish and list approved jobs, then sync applicant submissions back into Bullhorn.

Provision and manage recruiter users

Create and update CorporateUser records via /entity/CorporateUser and automate onboarding workflows across tenant accounts.

ORCHESTRATION

How Bullhorn works with Cyclr

Cyclr sits between your SaaS product and Bullhorn to handle authentication, govern access and orchestrate every API call per customer, at scale.

  1. 1

    Your SaaS product

    Your app requests an action for a specific customer.

  2. 2

    Cyclr orchestration

    Cyclr authenticates, applies policies and routes the request.

  3. 3

    Bullhorn

    Bullhorn processes the request and returns a response to your app.

Customer-specific authentication · Governed data movement · Centralized visibility and audit

CONNECTOR COVERAGE

Available connector capabilities

Explore Bullhorn methods you can orchestrate through Cyclr.

Corporations8

List My Corporations

Action

List all corporations that belong to the authenticated user.

List Updated Corporations

Action

List all corporations created or updated since the last successful run.

List Corporations

Action

List all corporations.

Get Corporation

Action

Get a corporation.

Update Corporation

Action

Update a corporation.

List New Corporations

Action

List all corporations created since the last successful run.

Create Corporation

Action

Create a corporation.

Get Corporation By Name

Action

Get a corporation by name.

Custom Entities6

Update Record

Action

Update the specified record.

Create Record

Action

Create a new record on the entity.

Delete Record

Action

Delete the specified record.

Get Record

Action

Returns the specified record.

Search Records

Action

Returns records which match the provided query

Query Records

Action

Returns records which match the provided query

Job Orders8

Delete Job Order

Action

Delete a job order.

Update Job Order

Action

Update a job order.

Get Custom Object Fields

Action

Retrieves the fields of a custom object associated with the Job Order object.

Get Job Order

Action

Get a job order.

List Updated Job Orders

Action

List all job orders created or updated since the last successful run.

List Job Orders

Action

List all job orders.

Create Job Order

Action

Create a job order.

List New Job Orders

Action

List all job orders created since the last successful run.

Business Sectors3

List Business Sectors

Action

Lists all business sectors.

Get Business Sector by Name

Action

Gets the business sector with the name provided.

Get Business Sector

Action

Gets the specified business sector.

Hotlists12

Get Hotlist By Name

Action

Get a hotlist by name.

List Hotlist Members

Action

List all hotlist members.

List Hotlists

Action

List all hotlists.

Add Contact to Hotlist

Action

Add a contact to a hotlist.

Create Hotlist

Action

Create a hotlist.

List Updated Hotlists

Action

List all hotlists created or updated since the last successful run.

Remove Candidate from Hotlist

Action

Remove a candidate from a hotlist.

List New Hotlist Members

Action

List all members of a hotlist created since the last successful run.

Remove Contact from Hotlist

Action

Removes a contact from a hotlist.

Get Hotlist

Action

Get a hotlist.

Add Candidate to Hotlist

Action

Add a candidate to a hotlist.

Delete Hotlist

Action

Delete a hotlist.

Notes8

Create Note

Action

Create a note.

List Notes For Entity

Action

List all notes for an entity.

Get Note

Action

Get a note.

Search Notes

Action

Search for notes matching a custom query.

Get Note Entity

Action

Get a note entity.

List New Notes

Action

List all notes created since the last successful run.

Update Note

Action

Update a note.

Delete Note

Action

Delete a note.

Certifications18

Update Certification

Action

Update details of a certification by ID.

List Updated Certifications

Action

Get a list of all certifications created or updated since the last successful run.

Get Certification

Action

Get details of a certification by ID.

List New Certifications

Action

Get a list of all certifications created since the last successful run.

List Certifications

Action

Get a list of all certifications.

Create Certification

Action

Create a new certification.

Get Certification File Attachment

Action

Get details of a certification file attachment by ID.

List Updated Certification Groups

Action

Get a list of all certification groups created or updated since the last successful run.

List New Certification File Attachments

Action

Get a list of all certification file attachments created since the last successful run.

List Updated Certification File Attachments

Action

Get a list of all certification file attachments created or updated since the last successful run.

List Certification Groups

Action

Get a list of all certification groups.

Update Certification Group

Action

Update a certification group by ID.

Update Certification File Attachment

Action

Update details of a certification file attachment by ID.

Create Certification Group

Action

Create a new certification group.

Create Certification File Attachment

Action

Create a new certification file attachment.

List Certification File Attachments

Action

Get a list of all certification file attachments.

Get Certification Group

Action

Get details of a certification group by ID.

List New Certification Groups

Action

Get a list of all certification groups created since the last successful run.

Placements31

List Placements by Candidate

Action

List all placements by candidate.

Update Placement

Action

Update a placement.

Delete Placement

Action

Delete a placement.

Get Placement

Action

Get a placement.

List Placements by Corporation

Action

List placements by the specified corporation.

List New Placements

Action

Lists all placements created since the last successful run.

List Updated Placements

Action

Lists all placements created or updated since the last successful run.

Create Placement

Action

Create a placement.

List Placements by Contact

Action

List placements by contact.

Get Placement Commission

Action

Get a placement commission.

List New Placement Commissions

Action

List all placement commissions created since the last successful run.

Get Placement Change Request

Action

Get a placement change request.

Create Placement Change Request

Action

Create a placement change request.

Create Placement Certification

Action

Create a new placement certification

List Placement Commissions by Placement

Action

List all placement commissions for the specified placement.

List Placement Change Requests

Action

List all placement change requests.

Update Placement Change Request

Action

Update a placement change request.

List New Placement Certifications

Action

Get a list of all placement certifications created since the last successful run.

Update Placement Certification

Action

Update details of a placement certification by ID.

Create Placement Commission

Action

Create a placement commission.

List New Placement Change Requests

Action

List all placement change requests created since the last successful run.

Get Placement Certification

Action

Get details of a placement certification by ID.

List Updated Placement Certifications

Action

Get a list of all placement certifications created or updated since the last successful run.

List Placement Commissions

Action

List all placement commissions.

Delete Placement Commission

Action

Delete a placement commission.

Approve Placement Change Request

Action

Approve a placement change request and updates the associated placement.

List Updated Placement Change Requests

Action

List all placement change requests created or updated since the last successful run.

Delete Placement Change Request

Action

Delete a placement change request.

List Placement Certifications

Action

Get a list of all placement certifications.

List Updated Placement Commissions

Action

List all placement commissions created or updated since the last successful run.

Update Placement Commission

Action

Update a placement commission.

Candidates21

Get Candidate

Action

Get a candidate.

Create Candidate

Action

Create a candidate.

Delete Candidate

Action

Delete a candidate.

List Updated Candidates

Action

List all candidates created or updated since the last successful run.

Search Candidates

Action

Search all candidates using the specified query.

List Candidates by Email

Action

List all candidates by email address.

List Candidate Appointments

Action

Lists all appointments for the specified candidate.

Get Candidate by Email

Action

Get a candidate by email address.

List Candidates

Action

List all candidates.

List My Candidates

Action

List all my candidates.

List Updated Candidates Incrementally

Action

Incrementally list all candidates created or updated since the last successful run.

List New Candidates

Action

List all candidates created since the last successful run.

Update Candidate

Action

Update a candidate.

Get Candidate Certification Requirement

Action

Get details of a Candidate Certification Requirement by ID.

List New Candidate Certification Requirements

Action

Get a list of all candidate certification requirements created since the last successful run.

List Candidate Attachments

Action

List the attachments for the specified candidate.

Create Candidate Certification Requirement

Action

Create a Candidate Certification Requirement.

Download Candidate Attachment

Action

Downloads the candidate's specified attachment.

Update Candidate Certification Requirement

Action

Update a Candidate Certification Requirement by ID.

List Candidate Certification Requirements

Action

Get a list of all Candidate Certification Requirements.

List Updated Candidate Certification Requirements

Action

Get a list of all candidate certification requirements created or updated since the last successful run.

Leads8

Delete Lead

Action

Delete a lead.

Get Lead

Action

Get a lead.

List Leads by Email

Action

List leads associated with an email address.

Update Lead

Action

Update a lead.

List Updated Leads

Action

List all leads created or updated since the last successful run.

List Leads

Action

List all leads.

List New Leads

Action

List all leads created since the last successful run.

Create Lead

Action

Create a lead.

Job Submissions14

Get Job Submission

Action

Get a job submission.

Delete Job Submission

Action

Delete a job submission.

List New Job Sumbissions

Action

List all job submissions created since the last successful run.

List Job Submissions

Action

List all job submissions.

Update Job Submission

Action

Update a job submission.

List Candidate Job Submissions

Action

List all job submissions for the specified candidate.

List Updated Job Submissions

Action

List all job submissions created or updated since the last successful run.

Create Job Submission

Action

Create a job submission.

Update Job Submission Certification Requirement

Action

Update a job submission certification requirement by ID.

Get Job Submission Certification Requirement

Action

Get details of a job submission certification requirement by ID.

List Updated Job Submission Certification Requirements

Action

Get a list of all job submission certification requirements created or updated since the last successful run.

List New Job Submission Certification Requirements

Action

Get a list of all job submission certification requirements created since the last successful run.

Create Job Submission Certification Requirement

Action

Create a new job submission certification requirement.

List Job Submission Certification Requirements

Action

List all job submission certification requirements.

Countries3

Get Country By Name

Action

Get a country by name.

List Countries

Action

List all countries.

Get Country By ID

Action

Get a country by ID.

Locations1

Get Location

Action

Get the Location details of a Client Corporation.

Appointments8

Search Appointments

Action

Search all appointments using the specified query.

List Updated Appointments

Action

Lists all appointments created or updated since the last successful run.

List New Appointments

Action

Lists all appointments created since the last successful run.

Delete Appointment

Action

Delete an appointment.

List Appointments

Action

Lists all appointments.

Create Appointment

Action

Create an appointment.

Update Appointment

Action

Update an appointment.

Get Appointment

Action

Get an appointment.

Events4

Get Event Subscription Last Request ID

Action

Get the last request ID of an event subscription.

List Events

Action

List events for the specified subscription

Upsert Event Subscription

Action

Create an event subscription to an entity for given event types.

Delete Event Subscription

Action

Delete an event type from a subscription.

Files2

Attach Base64-Encoded File

Action

Attach a file to an existing entity.

Attach Multi-Part File

Action

Attach a file to an existing entity.

Contacts12

List Contacts

Action

List all contacts.

List My Contacts

Action

List my contacts.

List Updated Contacts

Action

List all contacts created or updated since the last successful run.

List Updated Contacts Incrementally

Action

Incrementally list all contacts created or updated since the last successful run.

Get Contact by Email

Action

Get a contact by email.

List New Contacts

Action

List all contacts created since the last successful run.

Create Contact

Action

Create a contact.

Delete Contact

Action

Delete a contact.

Get Contact

Action

Get a contact.

List Contacts by Email

Action

List all contacts by email.

Update Contact

Action

Update a contact.

Get Contact (v2)

Action

Get a contact.

Opportunities5

List New Opportunities

Action

List all opportunities created since the last successful run.

Get Opportunity

Action

Get an opportunity.

List Updated Opportunities

Action

List all opportunities created or updated since the last successful run.

List Opportunities

Action

List all opportunities.

Create Opportunity

Action

Create an opportunity.

Users3

Get User

Action

Get a user.

List Users

Action

List all users.

Get User by Email Address

Action

Get a user by email address.

Skills2

List Skills

Action

List all skills.

Get Skill by Name

Action

Get a skill by name.

Owner Metrics2

List New Contact Owner Metrics

Action

List owner metrics for contacts created since the last run.

List New Candidate Owner Metrics

Action

Lists owner metrics for candidate records created since the last run.

Fields6

Get Fields For ClientContact

Action

Return the fields for ClientContact.

Get Metadata for Custom Objects

Action

Get metadata for custom objects as presented by the API.

Get Fields For Candidate

Action

Return the fields for Candidate.

Get Fields For Chosen Entity

Action

Return the fields for your chosen entity.

List Available Metadata Entities

Action

List all available metadata entities that are available.

Get Fields For ClientCorporation

Action

Return the fields for ClientCorporation.

Edit History3

List Field Changes for Edit History

Action

List all field changes associated with an edit history.

List Full Edit History for Entity

Action

List full edit history for an entity.

List Edit History for Entity

Action

List all edit history for an entity.

Tasks1

Create Task

Action

Create a new Task.

Associations1

Create To-Many Association

Action

Adds a To-Many association to a given entity.

TECHNICAL DETAILS

Bullhorn integration and API details

Review the sourced authentication and API behaviour used when configuring customer-facing Bullhorn integrations in Cyclr.

API and authentication

API host
https://rest.bullhornstaffing.com
Authentication
OAuth 2.0 with Bullhorn REST session exchange (access token then BhRestToken)
Credentials

OAuth client_id, client_secret and API username (and generated API user password).

Method categories

Entity CRUD (create/update/get), query/search, associations, massUpdate, file upload, event subscriptions.

View vendor API documentation →

Pagination and rate limits

Pagination

Offset-based pagination via start and count parameters on query and search endpoints; use POST body for large where clauses.

Rate limits

Throttling is not publicly documented and varies by contract; contact Bullhorn for tenant-specific limits.

IMPLEMENTATION

Authentication at a glance

Bullhorn uses OAuth 2.0. Exchange the OAuth access token for a BhRestToken and tenant restUrl via the REST login call.

Authentication method
OAuth 2.0 with Bullhorn REST session exchange (access token then BhRestToken)
Credential required

OAuth client_id, client_secret and API username (and generated API user password).

Before you begin:

Partner OAuth registration and support-requested API username required; some APIs gated to plan.

View setup guide

COMMON QUESTIONS

Frequently asked questions

It integrates Bullhorn staffing objects and workflows. You can create, retrieve and update Candidates, JobOrders, Placements and Notes, run searches and queries, and consume event subscriptions to drive downstream automations.

Bullhorn uses OAuth 2.0. Obtain an OAuth access token then call the REST login to receive a BhRestToken and tenant restUrl for API calls.

Yes. Cyclr supports per-customer credential management and multi-tenant orchestration so you can embed Bullhorn automations for each account without separate middleware.

Yes. Cyclr can surface Bullhorn CRUD, query, search and event subscription operations as governed MCP tools with centralized governance, per-tenant credentials and audit controls.