# Bullhorn

> Connect HeyMilo to Bullhorn so candidates flow in automatically and interview results push straight into Bullhorn Notes. Includes ATS connection, agent setup, mapping, and importing jobs from Bullhorn to auto-create agents.

## Agents Supported in Bullhorn

| SMS Agent                                                                                                                                                                                                                                                                            | Resume Agent                                                                                                                                                                                                                                                                                                                       | Voice/Video Agent                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ✅                                                                                                                                                                                                                                                                                    | ✅                                                                                                                                                                                                                                                                                                                                  | ✅                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><strong>How does it work?</strong></p><p>As soon as candidates apply, they get a text from Milo with your questions. They respond directly in the thread, just like a real conversation. Once they finish, Milo sends over the voice or video interview invite automatically.</p> | <p><strong>How does it work?</strong><br>Please be advised that the data is not automatically pulled from ATS. You can add resume screening to your agent workflow once the integration is live and your job is connected. Candidates will then be asked to upload their resume to get screened for fit before moving forward.</p> | <p><strong>How does it work?</strong></p><p>After integration and job posting mapping, when a candidate applies to your Bullhorn job posting, the candidate's email address is pulled from the application form and the candidate is engaged through email to take the voice/video assessment. Once the candidate has completed it, the candidate's detailed assessment report is attached to their profile in the Bullhorn portal.</p> |

{% hint style="info" %}
💡**HeyMilo supports SMS screening across all ATS platforms—as long as a valid phone number (with country code) is provided.** Since most ATSs don’t collect phone numbers by default, be sure to make the mobile number a required field in your job post.

Alternatively, you can enable both resume and SMS screening on your HeyMilo job, ensuring candidates are screened even if their phone number or resume isn’t accessible via your ATS.
{% endhint %}

## Why Use HeyMilo + Bullhorn?

<details>

<summary><strong>⭐️ Seamless Candidate Sync</strong></summary>

Automatically sync candidates from Bullhorn into HeyMilo, eliminating manual effort.

</details>

<details>

<summary><strong>⭐️ AI Insights Where You Work</strong></summary>

Interview summaries, transcripts, and recordings are written directly to Bullhorn—so recruiters and hiring managers can review feedback right inside the platform.

</details>

<details>

<summary><strong>⭐️ Job-Specific Interview Agent Mapping</strong></summary>

Map HeyMilo agents to specific Bullhorn job postings to ensure accurate and personalized assessments.

</details>

## Setting Up the Integration

Watch this video, and follow the steps below to learn how to connect HeyMilo in Bullhorn:

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKCgmPgkC7X1VTl62ocK%2Fuploads%2FzfAgce0IQbpFjR4yN4xD%2FBullhorn.mp4?alt=media&token=4efd481f-bd15-4119-8657-2b5cdac681e8>" %}

### 🛠 What You’ll Need to Get Started

Before connecting Bullhorn with HeyMilo, you'll need:

* ✅ Admin access to your HeyMilo workspace
* ✅ Bullhorn **Client ID** and **Client Secret** (requested from Bullhorn Support)
* ✅ Bullhorn **API Username**
* ✅ **Redirect URI registered** with Bullhorn Support: `https://api.sifaka.heymilo.ai/api/ext/ats/auth/bullhorn/callback`

{% hint style="info" %}
**How to get your Bullhorn API credentials**

Bullhorn API credentials are not self-service — you need to contact Bullhorn Support to request them. Send a support ticket via the [Bullhorn Resource Center](https://www.bullhorn.com/) with the following:

> Hi Bullhorn Support,
>
> We are integrating with HeyMilo and need API access for our Bullhorn instance. Could you please:
>
> 1. Create an API user for our HeyMilo integration
> 2. Provide the **Client ID** and **Client Secret**
> 3. Register the following **redirect URI** on the API key: `https://api.sifaka.heymilo.ai/api/ext/ats/auth/bullhorn/callback`
>
> Please ensure Terms of Service is disabled for this API user.
>
> Thank you.

Bullhorn Support typically responds within 1–3 business days. Once you receive your Client ID, Client Secret, and API Username, you can proceed with the setup below.
{% endhint %}

### Setting Up the Candidate Widget

Add the HeyMilo widget to your Bullhorn candidate profiles so your team can view interview results without leaving Bullhorn.

1. In Bullhorn, go to Menu → Admin → View Layout and select Candidate as the entity.
2. In HeyMilo, go to Integrations → Bullhorn → Manage, scroll to the Candidate Widget URL, and copy it.
3. Back in Bullhorn, paste the URL into a Custom Tab in the Candidate layout.

The widget will now appear on every candidate profile.

### Connect HeyMilo to Bullhorn

{% stepper %}
{% step %} <mark style="color:blue;">**Step 1**</mark> Connect through the Connect to your ATS tab after creating an agent

<figure><img src="/files/9cLQdpdhcLcW9g0MOwb9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 2**</mark> Or go to Integrations on the side panel and under the Bullhorn section

* Click **Connect Now**

<figure><img src="/files/CH3omdYD2Wq9ZeVGlVoe" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 3**</mark> Enter Your Bullhorn API Credentials and Set a Polling Interval

Enter only the following (received from Bullhorn Support):

* **Client ID**
* **Client Secret**
* **API Username**

Then set a polling interval (1–1440 minutes). The polling interval determines how often HeyMilo checks Bullhorn for new candidates.

<figure><img src="/files/xuZHexVsa3QxdnmWfDpu" alt=""><figcaption></figcaption></figure>

* Enter a **lower value** (e.g., `5`) to fetch new applicants more frequently.
* Use a **higher value** (e.g., `1440`) if real-time syncing is not critical.

Make sure to enter the value in minutes.

<figure><img src="/files/8wdoTFpHKOqTlNjSodCv" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Example: A 10-minute polling interval means HeyMilo will check Bullhorn every 10 minutes for updates.
{% endhint %}
{% endstep %}

{% step %} <mark style="color:blue;">**Step 4**</mark> Click Connect and log into Bullhorn

Click **Connect**. You will be redirected to the Bullhorn login page.

{% hint style="warning" %}
**Important:** Log in with your own **Bullhorn user credentials** (not the API credentials). This is a one-time OAuth authorization flow — your Bullhorn password is **not** stored in HeyMilo.
{% endhint %}

After logging in and approving access, you will be automatically redirected back to HeyMilo. The integration is now connected.
{% endstep %}
{% endstepper %}

### Create a Screening Agent

{% stepper %}
{% step %} <mark style="color:blue;">**Step 1**</mark> Log in to HeyMilo Admin (<https://admin.heymilo.ai>)
{% endstep %}

{% step %} <mark style="color:blue;">**Step 2**</mark> Click the Create Interviewer button to create a screening agent

<figure><img src="/files/jmwGhnLSfCvjrIqbtxP4" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 3**</mark> Fill in the necessary configurations and complete the setup flow

<figure><img src="/files/2jMQWhX4ErJbAlRV9j3K" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Mapping HeyMilo Agents to Bullhorn Jobs

You can map bullhorn jobs with HeyMilo agent using our agent-ats mapping feature.

{% stepper %}
{% step %} <mark style="color:blue;">**Step 1**</mark> From your active agent, select Integrations from the actions menu

<figure><img src="/files/GCXgbCmnKYg7Yd4Vsv2k" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 2**</mark> Scroll to ATS Integrations section

<figure><img src="/files/gjivBDTvJbwzGLOUixKi" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 3**</mark> Select Bullhorn as your ATS Type

* Select Job Posting ID as a Mapping Parameter, and paste your Bullhorn Job ID from the Bullhorn portal here.

<figure><img src="/files/Q1iZtEOsNYbHDErEFHDZ" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 4**</mark> Next, click add and Save the configuration. Once Mapping is added you will get a success toast!
{% endstep %}
{% endstepper %}

### Automatic Candidate Sync

Candidates added to mapped Bullhorn jobs will be ingested into HeyMilo at the configured polling interval.

Each candidate will receive an interview invitation email automatically.

<figure><img src="/files/J3NfGqix84xaQYrIo8XB" alt=""><figcaption><p>Automated email invitation to candidates</p></figcaption></figure>

### Results & Feedback in Bullhorn

When the interview is finished, HeyMilo generates a structured report—complete with transcripts, AI summaries, and scores—and adds it to the candidate’s **Notes** in Bullhorn.

<figure><img src="/files/fIbiyLkpUMgiZ48Gw9Gx" alt=""><figcaption><p>Notes in Bullhorn</p></figcaption></figure>

### Option 2: 📥 Import Jobs from Bullhorn (Auto-Create Agents)

Skip the manual setup. You can import jobs directly from Bullhorn and HeyMilo will automatically create an agent for each one — ready to start screening as soon as candidates apply.

**Where to find it**: HeyMilo → Integrations → Import from ATS

<figure><img src="/files/3lBEEvEydBue20te6tZt" alt=""><figcaption></figcaption></figure>

**What this does**: Pulls in your active Bullhorn jobs and auto-creates a matching HeyMilo agent per job, pre-mapped to the Bullhorn Job ID. No copy-pasting, no one-by-one setup.

## Additional resources

For additional information not covered here, reach out to <support@heymilo.ai>.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.admin.heymilo.ai/integrations/ats-integration/bullhorn.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.