BullhornHub Phone Utils icon

BullhornHub Phone Utils

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

Actions10

Phone Geo → Get Timezone

AI-generated

Summary

Retrieve IANA timezone information for one or multiple phone numbers using BullhornHub Phone Geo services.

Inputs

  • Authentication (required) — Choose between User Credentials (Email & Password) or Enterprise Credentials (API Key) for BullhornHub API authentication.
  • Input Mode (required) — Select how phone numbers are provided: Manual Input (direct entry), Field Mapping (map fields from input data), or Bullhorn Entity (use Bullhorn entity field presets).
  • Phone Number(s) (required) — Phone number(s) to process, required if Manual Input is selected. Separate multiple numbers with commas.
  • Source Field (required) — Field name containing the phone number in input data, required if Field Mapping mode is selected.
  • Output Field — Field name to store the timezone result; if empty when using Field Mapping mode, source field name is used with a suffix.
  • Entity Type (required) — Bullhorn entity type to process (Candidate, Client Contact, Client Corporation, or Lead), required if Bullhorn Entity mode is selected.
  • Phone Fields (required) — Specify which phone fields of the Bullhorn entity to process, used with Bullhorn Entity input mode.
  • Batch Mode — Process all input items in a single API call for efficiency with large datasets, applicable when Input Mode is not Manual.
  • Error Handling (required) — Determine how errors are handled: Fail Fast (stop on first error), Continue (skip errors), or Collect Errors (include errors alongside results).
  • Default Country (required) — Set default country for parsing numbers without country codes (e.g., US, GB, CA).
  • Country Code — ISO 3166-1 alpha-2 country code for 'Other' default country selection.
  • Locale (required) — Select language for location and carrier names in the response.

Output shape

a list of items where each item's JSON contains the original data augmented with the phone timezone information; output field names depend on input mode and user configuration.

Supports multiple phone numbers per item, batch processing for bulk input, and multiple input modes (manual, field mapping, Bullhorn entity). Errors are handled according to the selected error mode, and detailed error information may be included in output items if 'Collect Errors' is chosen.

Examples

Example 1: Manual input of multiple phone numbers to retrieve timezone data

Set Authentication to Enterprise Credentials, Input Mode to Manual Input, provide comma-separated phone numbers in 'Phone Number(s)', set Default Country as needed, and select Locale for language preference.

Example 2: Process phone numbers from a specific field in incoming data records

Set Input Mode to Field Mapping, specify Source Field containing phone numbers, optionally set Output Field name, enable Batch Mode for efficiency with large datasets, and configure error handling behavior.

Example 3: Retrieve timezones for phone fields within Bullhorn entity records

Choose Bullhorn Entity input mode, select the Bullhorn entity type and phone fields to process, configure batch mode and error handling, and provide necessary authentication credentials.

Links

Discussion