BullhornHub Phone Utils icon

BullhornHub Phone Utils

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

Actions10

Phone Utils → Format

AI-generated

Summary

Format phone numbers using BullhornHub's phone utilities in specified output formats like E.164, National, International, RFC3966, or a human-readable Display format.

Inputs

  • Authentication — Choose between User Credentials (Email & Password) or Enterprise Credentials (API Key) for BullhornHub API authentication.
  • Input Mode (required) — Select how to provide phone numbers: Manual Input (direct entry), Field Mapping (map input data field), or Bullhorn Entity (use Bullhorn entity phone fields).
  • Phone Number(s) (required) — For Manual Input mode, enter one or more phone numbers as a comma-separated string.
  • Source Field (required) — For Field Mapping mode, specify the name of the field in input data that contains the phone number to format.
  • Output Field — For Field Mapping mode, optionally specify the field name to store formatted output. If omitted, a field name suffix is appended to source field.
  • Entity Type (required) — For Bullhorn Entity mode, specify the entity type (Candidate, Client Contact, Client Corporation, or Lead) to process.
  • Phone Fields (required) — For Bullhorn Entity mode, choose which phone fields of the entity to format.
  • Batch Mode — For Field Mapping or Bullhorn Entity modes, optionally process all input items in a single API request for efficiency.
  • Error Handling (required) — Choose how to handle errors during processing: Fail Fast (stop on error), Continue (skip errors), or Collect Errors (include error info in output).
  • Default Country (required) — Set the default country for parsing numbers without a country code (e.g., US, GB, CA, AU, DE, FR, or Other).
  • Country Code — If Default Country is Other, specify the ISO 3166-1 alpha-2 country code (e.g., JP, BR, IN).
  • Output Format (required) — Select the format for the output phone number: E.164, National, International, RFC3966, or Display (human-readable).

Output shape

a list of items corresponding to input data items, each including formatted phone number(s) in specified output format, with fields based on input mode

Supports processing multiple phone numbers per input. Batch mode consolidates multiple items into fewer API calls. Errors are handled per selected error mode, potentially included in output with error details. Maximum 100 phone numbers per request.

Examples

Example 1: Format a manual list of phone numbers to E.164 format

Set Input Mode to Manual Input and enter phone numbers separated by commas. Choose Output Format as E.164.

Example 2: Format a phone number field from incoming data

Set Input Mode to Field Mapping, specify the Source Field that contains phone numbers, and optionally set an Output Field name. Choose desired Output Format.

Example 3: Format multiple phone fields of Bullhorn entity records

Set Input Mode to Bullhorn Entity, select the Entity Type and phone fields to format, then choose Output Format. Enable Batch Mode for efficiency on large datasets.

Links

Discussion