BullhornHub Geo Utils icon

BullhornHub Geo Utils

Address utilities: validate, normalize, format, convert, compare addresses

Actions10

Address Convert → To Bullhorn

AI-generated

Summary

Convert address data from various input modes into Bullhorn address format, optionally normalizing before conversion.

Inputs

  • authentication — Choose authentication method: User Credentials (Email & Password) or Enterprise Credentials (API Key). Defaults to Enterprise.
  • inputMode (required) — Specify how the address data is provided: Manual Input (enter fields directly), Bullhorn Entity (use existing Bullhorn entity address field presets), or Parse Address String (parse an unstructured address string).
  • address1 — Street address line 1, used in Manual Input mode.
  • address2 — Street address line 2 (e.g., suite, apt), used in Manual Input mode.
  • city — City name, used in Manual Input mode.
  • state — State, province, or region, used in Manual Input mode.
  • zip — ZIP or postal code, used in Manual Input mode.
  • countryCode — ISO 3166-1 alpha-2 country code, used in Manual Input mode.
  • parseAddressString (required) — Free-form address string to parse, required if input mode is Parse Address String.
  • bullhornEntityType (required) — Type of Bullhorn entity (Candidate, Client Contact, or Client Corporation) whose address fields to convert, used in Bullhorn Entity input mode.
  • bullhornAddressFields — Which Bullhorn address fields to process (Primary Address, Secondary Address) in Bullhorn Entity mode.
  • errorMode — Error handling strategy: Fail Fast, Continue on errors, or Collect errors alongside results. Defaults to Fail Fast.
  • defaultCountry — Default country for normalization and validation when no country is specified. Options include US, GB, CA, AU, DE, FR, IE, or Other.
  • customCountry — ISO 3166-1 alpha-2 code for custom country when defaultCountry is Other.
  • normalizeFirst — Boolean indicating whether to normalize the address before converting to Bullhorn format. Defaults to true and is recommended for better results.

Output shape

a JSON object representing the address in Bullhorn's address schema

The operation outputs structured address data formatted for Bullhorn based on the given input mode and normalization option. Errors are handled according to the selected errorMode setting. The conversion uses normalization where enabled to align input addresses with Bullhorn conventions.

Examples

Example 1: Convert a manually entered address to Bullhorn format with normalization

Authentication: Enterprise, Input Mode: Manual, Address Line 1: '123 Main St', City: 'San Francisco', State: 'CA', ZIP: '94105', Country Code: 'US', Normalize First: true.

Example 2: Parse a free-form address string and convert to Bullhorn address

Authentication: Enterprise, Input Mode: Parse Address String, Address String: '123 Main St, San Francisco, CA 94105, US', Normalize First: true.

Example 3: Convert address fields from a Bullhorn Candidate entity's primary address

Authentication: Enterprise, Input Mode: Bullhorn Entity, Entity Type: Candidate, Address Fields: Primary Address, Normalize First: true.

Links

Discussion