Candidate Mobile and Home Number Fields

Overview

This article explains how a Candidate's mobile and home phone numbers are shown in Bullhorn Automation.

By default, certain fields on every record are automatically synced with your Bullhorn ATS. In Bullhorn Automation, we refer to these fields as default fields. Most of these default fields mirror the field name in Bullhorn ATS, however, certain fields like the mobile and phone fields are unique.

Finding a Candidate's Mobile Number

This field is shown as Candidate Phone inside of Bullhorn Automation.

Bullhorn Automation uses the mobile field in Bullhorn ATS by default, but for your benefit, we've made the Bullhorn Automation Candidate Phone field "smart". In records where a mobile number does not exist, Bullhorn Automation will automatically use the phone field in Bullhorn ATS as a backup number.

Let's break this logic down a bit further:

1. If a number is listed in the mobile field, that's what is used in the Candidate Phone field in Bullhorn Automation.
   
   Candidate Phone in Bullhorn Automation = 999-555-1234
   
2. If the mobile field is empty, Bullhorn Automation pulls from the value in the phone field instead.
   
   Candidate Phone in Bullhorn Automation = 777-555-4567
3. If both fields contain a value, Bullhorn Automation pulls from the mobile field and uses this value as the Candidate Phone.
   
   Candidate Phone in Bullhorn Automation = 999-555-1234
4. If both the mobile and phone fields are empty, the Candidate is marked as not having a phone number in Bullhorn Automation.
   

FAQ

I sent out a survey to update Candidate contact information, which phone number will this update in Bullhorn ATS?

Great use of the survey feature! When a candidate updates their phone number using a survey question, this will only update the mobile field in Bullhorn ATS. If a mobile number already exists for this Candidate, upon completing this survey, Bullhorn Automation will replace the existing field value with what they input for this question.

Can I run an automation to update the field "phone" to "mobile" in Bullhorn ATS?

Since Bullhorn Automation uses both Bullhorn ATS fields for phone numbers, they cannot be treated as separate fields and cannot be updated individually. It therefore wouldn't be possible to copy data from mobile to phone or vice versa.

Bullhorn ATS does offer two other phone fields that interact individually with Bullhorn Automation, phone2 and workPhone. These fields can be manually synced in the Bullhorn Integration Settings for automations including updates to candidate records. These can be useful for storing historic data if needed.

Pro Tip: Having trouble finding the field you need? They might be hidden! Make sure you click Show Hidden Fields at the bottom of the Bullhorn Integration Settings list and then use Ctrl + F to search by keyword.

I'm looking for "phone2" or "phone3" fields in Bullhorn Automation, but I can't find them. Where are they?

If a field isn't one of the default fields (in the grayed-out box at the top of Bullhorn Integration Settings), then Bullhorn Automation stores the label of that field instead of the name.

Visit your Admin folder in Bullhorn ATS and open your Field Mappings page to verify the field name and its associated label.

For example, the phone2 field on the Candidate entity may be labeled as Other Phone in your Bullhorn ATS field mappings. In Bullhorn Automation, it will show this label rather than phone2, since it is not a default field.

Example in Bullhorn ATS field mappings:

In Bullhorn Integration Settings located in Bullhorn Automation:

In Bullhorn Automation list logic, you'll see Other Phone as the selection. You can still use Candidate Phone (logic described above) and Candidate Other Phone inside of Bullhorn Automation, including searching, saving to Bullhorn ATS via surveys, and within update steps.