BullhornHub Phone Utils icon

BullhornHub Phone Utils

Phone number utilities: parse, format, validate, geocode, carrier, timezone

Actions10

Phone Geo → Geocode

AI-generated

Summary

Geocode phone numbers to retrieve their geographic location names (e.g., "San Francisco, CA").

Inputs

  • Authentication (required) — Choose authentication method: User Credentials (Email & Password) or Enterprise Credentials (API Key).
  • Input Mode (required) — Specify how to provide phone numbers for geocoding: Manual Input (enter phone numbers directly), Field Mapping (map phone numbers from an input data field), or Bullhorn Entity (use Bullhorn entity phone fields).
  • Phone Number(s) (required) — When Manual Input is selected, enter one or multiple phone numbers separated by commas to geocode.
  • Source Field (required) — When Field Mapping is selected, specify the name of the input data field containing the phone number to geocode.
  • Output Field — When Field Mapping is selected, specify the field name to store the geocode result. If left empty, the source field name with a suffix is used.
  • Entity Type (required) — When Bullhorn Entity mode is selected, choose the Bullhorn entity type to retrieve phone fields from (e.g., Candidate, Client Contact).
  • Phone Fields (required) — When Bullhorn Entity mode is selected, select which phone fields on the entity to geocode.
  • Batch Mode — When not using Manual Input, optionally enable to process all input items in a single batch API call for efficiency.
  • Error Handling (required) — Set handling of errors during processing: Fail Fast (stop on first error), Continue (skip errors), or Collect Errors (return errors alongside results).
  • Default Country (required) — Set the default country for parsing phone numbers without country codes (e.g., US, GB).
  • Country Code — If Default Country is set to Other, specify a two-letter ISO country code (e.g., JP, BR) for default parsing.
  • Locale (required) — Select the language locale for location names in the geocode results (e.g., English, German, Japanese).

Output shape

a list of items, each containing the original data and an added field with the geocode result for the corresponding phone number(s).

Supports input via manual phone number string, field from incoming data items, or Bullhorn entity phone fields with optional batch processing. Returns per-phone geocode location names localized by the chosen language. Errors are handled according to the selected mode, which may cause processing to stop, continue skipping errors, or include error details in output items.

Examples

Example 1: Manual input of phone numbers for geocoding

Set Input Mode to Manual Input and enter one or more phone numbers to obtain their geographic locations.

Example 2: Geocode phone numbers from a field in incoming data

Set Input Mode to Field Mapping, specify the source field containing phone numbers, and optionally set an output field for geocode location results.

Example 3: Geocode phone fields of Bullhorn entities

Set Input Mode to Bullhorn Entity, choose the entity type, and select which phone fields to geocode from those entities.

Links

Discussion