BullhornHub Phone Utils icon

BullhornHub Phone Utils

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

Actions10

Phone Geo → Get Carrier

AI-generated

Summary

Get the mobile carrier name for one or more phone numbers using BullhornHub Phone Geo services.

Inputs

  • Authentication (required) — Choose authentication method: User Credentials (Email & Password) or Enterprise Credentials (API Key).
  • Input Mode (required) — Select how to provide phone numbers for processing: Manual Input (direct entry), Field Mapping (from input data fields), or Bullhorn Entity (preset Bullhorn entity phone fields).
  • Phone Number(s) (if Manual Input) (required) — Enter one or more phone numbers separated by commas (e.g., +1 (415) 555-2671, +44 20 7123 4567).
  • Source Field (if Field Mapping) (required) — Specify the input data field name containing the phone number to process.
  • Output Field (if Field Mapping) — Optional field name for storing the result; if empty, the source field name is appended with a suffix.
  • Entity Type (if Bullhorn Entity) (required) — Select Bullhorn entity type whose phone fields to process (Candidate, Client Contact, Client Corporation, Lead).
  • Phone Fields (if Bullhorn Entity) (required) — Select one or more phone fields of the chosen Bullhorn entity to process.
  • Batch Mode — Enable to process all input items in a single API call for improved efficiency on large datasets (only for Field Mapping and Bullhorn Entity input modes).
  • Error Handling (required) — Set error handling strategy: Fail Fast (stop on first error), Continue (skip errors), or Collect Errors (include errors with results).
  • Default Country (required) — Set default country for parsing numbers without country code (US, GB, CA, AU, DE, FR, Other).
  • Country Code (if Default Country is Other) — Specify ISO 3166-1 alpha-2 code for default country (e.g., JP, BR, IN).
  • Locale (required) — Language for carrier name output (e.g., English, German, Spanish, French, etc.).

Output shape

a list of results, each containing the carrier name associated with each processed phone number

If using Field Mapping or Bullhorn Entity input, output items preserve original data with carrier info added to a specified or auto-generated field name. Supports up to 100 phone numbers per API request. Error handling behavior follows the selected policy; errors may halt execution or be included in output as detailed.

Examples

Example 1: Manually input phone numbers to retrieve their mobile carrier names.

Set Authentication, Input Mode to 'Manual Input', provide one or more phone numbers, choose locale, and run the node to get carrier info for each number.

Example 2: Map phone numbers from input data fields to enrich with carrier names.

Set Authentication, Input Mode to 'Field Mapping', specify source and output fields, enable batch mode if needed, and set error handling mode.

Example 3: Process phone fields in Bullhorn entity records to get carrier names.

Set Authentication, Input Mode to 'Bullhorn Entity', select entity type and phone fields, configure batch and error handling options, then execute to add carrier information to data.

Links

Discussion