BullhornHub Geo Utils icon

BullhornHub Geo Utils

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

Actions10

Address Utils → Validate

AI-generated

Summary

Validate address data provided through manual entry, Bullhorn entity fields, or parsing a free-form address string, using BullhornHub's address validation capabilities.

Inputs

  • authentication — Choose between User Credentials (Email & Password) and Enterprise Credentials (API Key) for BullhornHub authentication.
  • inputMode (required) — Select how to provide the address data: manual fields input, Bullhorn entity address presets, or parsing a free-form address string.
  • address1 — Street address line 1, used in Manual Input mode.
  • address2 — Street address line 2 (suite, apt, etc.), 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 for the address, used in Manual Input mode.
  • parseAddressString (required) — Free-form address string to parse for validation, required when using Parse Address String input mode.
  • bullhornEntityType (required) — Bullhorn entity type (Candidate, Client Contact, Client Corporation) when using Bullhorn Entity input mode.
  • bullhornAddressFields (required) — Specify which Bullhorn address fields (Primary or Secondary) to process in Bullhorn Entity input mode.
  • errorMode — Error handling strategy: Fail Fast (stop on first error), Continue (skip errors), or Collect Errors (include errors in output). Defaults to Fail Fast.
  • defaultCountry — Default country to use for validation and normalization when no country is specified, defaults to United States (US).
  • customCountry — ISO 3166-1 alpha-2 country code used as default when 'Other' is selected for Default Country.

Output shape

a list of validated address objects, each indicating success or error details depending on error handling settings

Output includes validated address data. When 'Collect Errors' errorMode is selected, the output contains both successful and failed validations with error details. The node handles multiple input items and processes each accordingly.

Examples

Example 1: Validate a manually entered address

Set Input Mode to Manual Input, fill required address fields, select authentication method, and run validation.

Example 2: Validate addresses from Bullhorn entity records

Select Input Mode as Bullhorn Entity, specify entity type and address fields, choose authentication, and validate.

Example 3: Parse and validate free-form address string

Set Input Mode to Parse Address String, provide the address string, pick authentication, and execute.

Links

Discussion