BullhornHub Phone Utils icon

BullhornHub Phone Utils

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

Actions10

Phone Utils → Validate

AI-generated

Summary

Validate phone numbers for correctness and format using BullhornHub API, supporting manual input, field mapping, or Bullhorn entity presets.

Inputs

  • authentication — Choose between 'User Credentials (Email & Password)' or 'Enterprise Credentials (API Key)' for BullhornHub API authentication.
  • inputMode (required) — Specify how to supply phone numbers: 'Manual Input' to provide numbers directly; 'Field Mapping' to extract phone numbers from input data fields; or 'Bullhorn Entity' to use preset phone fields from Bullhorn entities.
  • phones (required) — In 'Manual Input' mode, enter one or multiple phone numbers to validate, separated by commas.
  • sourceField (required) — In 'Field Mapping' mode, the name of the input data field containing the phone number.
  • outputField — In 'Field Mapping' mode, specify the output field name for validation results; if empty, a default suffixed field name is used.
  • bullhornEntityType (required) — In 'Bullhorn Entity' mode, select the type of Bullhorn entity whose phone fields to validate (e.g., Candidate, Client Contact).
  • bullhornPhoneFields (required) — In 'Bullhorn Entity' mode, select which phone fields on the entity to validate.
  • batchMode — Determine if all input items should be processed in a single API call for efficiency; applicable only with 'Field Mapping' or 'Bullhorn Entity' input modes.
  • errorMode (required) — Configure error handling behavior: 'Fail Fast' stops on first error, 'Continue' skips errors, 'Collect Errors' includes errors in the output alongside successes.
  • defaultCountry (required) — Default country code to parse phone numbers lacking a country code; choose from predefined countries or 'Other'.
  • customCountry — When 'Other' is selected as default country, provide a specific ISO 3166-1 alpha-2 country code (e.g., JP, BR).

Output shape

a list of items each containing validation results for phone numbers, or enriched input items when using field mapping or Bullhorn entity modes

Supports batch processing of up to 100 phone numbers per API request. Returns a detailed validation result per phone number. Error handling behavior depends on the selected 'Error Handling' mode, possibly including error details alongside successful results.

Examples

Example 1: Manual Input Mode

User supplies one or more phone numbers directly via the 'Phone Number(s)' input parameter, and the node returns validation information for these numbers in separate output items.

Example 2: Field Mapping Mode

User specifies an input data field containing phone numbers. The node processes each input item, validates its phone number field, and appends validation results to the output data, optionally under a custom output field name.

Example 3: Bullhorn Entity Mode

User selects a Bullhorn entity type and one or more phone fields of that entity. The node validates these phone numbers for each input item and appends validation results for each phone field.

Links

Discussion