BullhornHub Phone Utils icon

BullhornHub Phone Utils

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

Actions10

Phone Utils → Detect Type

AI-generated

Summary

Detect the type of one or more phone numbers (e.g., mobile, fixed-line) using the BullhornHub Phone Utils API.

Inputs

  • Authentication (required) — Choose between User Credentials (Email & Password) or Enterprise Credentials (API Key) for authentication.
  • Input Mode (required) — Select how to provide phone numbers: Manual Input, Field Mapping from input data, or Bullhorn Entity phone fields.
  • Phone Number(s) (required) — Enter one or more phone numbers separated by commas, used when Input Mode is Manual Input.
  • Source Field (required) — Specify the input data field containing the phone number, used when Input Mode is Field Mapping.
  • Output Field — Field name for output result when using Field Mapping; if empty, a field with a suffix is used.
  • Entity Type (required) — Select the Bullhorn entity type (Candidate, Client Contact, Client Corporation, Lead) when using Bullhorn Entity input mode.
  • Phone Fields (required) — Select which Bullhorn phone fields to process when using Bullhorn Entity mode.
  • Batch Mode — Enable to process all input items in a single API call for efficiency, applicable when input mode is not manual.
  • Error Handling (required) — Choose error handling behavior: Fail Fast, Continue processing, or Collect Errors.
  • Default Country (required) — Default country code to use when parsing numbers without country code.
  • Country Code — Specify a custom ISO 3166-1 alpha-2 country code if Default Country is set to Other.

Output shape

a list of items corresponding to input phone numbers with detected phone type information included

The output includes detected phone type results either directly for Manual Input mode or merged back into input items in Field Mapping or Bullhorn Entity modes. Supports batch processing with up to 100 phone numbers per request. Errors are handled according to the configured mode (fail fast, continue, or collect). If multiple phone numbers are provided manually, each phone produces one output item with detection results.

Examples

Example 1: Manual input of multiple phone numbers to detect their phone types

Authentication set to Enterprise Credentials, Input Mode set to Manual Input, multiple phone numbers entered separated by commas, Default Country set to United States, Batch Mode disabled, and Error Handling set to Fail Fast.

Example 2: Detect phone types from phone fields of Bullhorn Candidate entity

Authentication set to User Credentials, Input Mode set to Bullhorn Entity, Entity Type set to Candidate, Phone Fields set to Phone and Mobile, Default Country set to United States, Batch Mode enabled, and Error Handling set to Collect Errors.

Links

Discussion