Overview

The Bullhorn node allows you to connect Flowmage with the Bullhorn REST API using OAuth 2.0.

You can perform operations on Bullhorn entities such as Candidates, JobOrders, and more—making it ideal for recruitment and staffing automations.

When to Use This Node

Use the Bullhorn node when you want to:

• Retrieve candidate or job data

• Create or update records in Bullhorn

• Sync recruitment data between systems

• Automate hiring workflows

• Integrate Bullhorn with other tools

Configuration

The Bullhorn node is structured in 4 steps:

1. Authentication

OAuth 2.0 Credentials

You need to configure your Bullhorn API credentials.

Client ID

Your Bullhorn application Client ID.

Client Secret

Your Bullhorn application Client Secret.

Username

API username for Bullhorn.

Password

API password for Bullhorn.

Authentication Flow

Flowmage automatically handles:

• Authorization

• Token exchange

• Token refreshing

? No manual OAuth handling required.

Test Connection

Click “Test Connection” to verify your credentials.

2. Operation

Operation Type

Select how you want to interact with Bullhorn.

Example:

Entity (CRUD)

Entity Type

Select the Bullhorn entity.

Examples:

• Candidate

• JobOrder

• Placement

Action

Choose what to do:

• Get (Retrieve)

• Create

• Update

• Delete

Example:

Get (Retrieve)

3. Parameters

Entity ID

The ID of the record you want to retrieve or update.

Example:

12345

? You can also use variables:

@previousNode.candidateId@

Fields to Include

Specify which fields you want returned.

Example:

id, firstName, lastName

? This improves performance by limiting the response size.

4. Advanced

Continue on Error

If enabled, the flow continues even if the API call fails.

In-Depth Logging

Logs full request and response data (headers, body, etc.).

? Useful for debugging.

Show System Fields

Includes internal Bullhorn system fields in the response.

How It Works

1. Flow reaches the Bullhorn node

2. OAuth authentication is handled automatically

3. API request is executed

4. Bullhorn returns data or confirmation

5. Output becomes available for next steps

Output / Variables

The node returns data from Bullhorn.

Example usage:

@bullhorn.firstName@
@bullhorn.lastName@
@bullhorn.id@

? bullhorn = your Output ID

Example Use Cases

Retrieve Candidate

Entity: Candidate  
Action: Get  
Entity ID: @trigger.candidateId@

Update Candidate

Entity: Candidate  
Action: Update  
Entity ID: @candidate.id@

Sync Candidate Data

• Retrieve candidate from Bullhorn

• Send to CRM

• Update status

Common Mistakes

❌ Invalid Credentials

Authentication fails.

✅ Double-check Client ID, Secret, Username, and Password

❌ Missing Entity ID

Required for GET/UPDATE/DELETE.

✅ Always provide a valid ID

❌ Requesting Too Many Fields

Can slow down performance.

✅ Only request needed fields

❌ Incorrect Entity Type

Wrong entity selected.

✅ Verify entity matches your use case

Pro Tips

• Use field filtering to improve speed

• Enable logging when debugging issues

• Combine with conditions to handle API responses

• Use variables to dynamically select records

• Reuse this node across recruitment workflows

Summary

The Bullhorn node enables seamless integration with the Bullhorn API, allowing you to automate recruitment processes and manage data efficiently.

With OAuth handled automatically and flexible operations, you can build powerful hiring workflows inside Flowmage.