Sourcier Phone Utils icon

Sourcier Phone Utils

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

Actions10

Phone Utils → Normalize

AI-generated

Summary

Normalize phone numbers into Bullhorn-compliant E.164 format from manual input, mapped fields, or Bullhorn entity presets.

Inputs

  • Authentication (required) — Choose between User Credentials (email and password) or Enterprise Credentials (API key) for Sourcier API authentication.
  • Input Mode (required) — Select how phone numbers are provided: Manual Input (direct entry), Field Mapping (from input data field), or Bullhorn Entity (using Bullhorn phone field presets).
  • Phone Number(s) (required) — Enter one or more phone numbers separated by commas (shown when Manual Input mode is selected).
  • Source Field (required) — Name of the input data field containing phone numbers (used in Field Mapping mode).
  • Output Field — Name of the output field for normalized numbers; if empty, original source field name with a suffix is used (Field Mapping mode).
  • Entity Type (required) — Bullhorn entity type to process phone fields for (Candidate, Client Contact, Client Corporation, or Lead).
  • Phone Fields (required) — Which Bullhorn phone fields to normalize (e.g., phone, mobile) when using Bullhorn Entity input mode.
  • Batch Mode — Optionally process all input items in a single API request for efficiency (not available for Manual Input).
  • Error Handling (required) — Choose error handling strategy: Fail Fast (stop on first error), Continue (skip errors), or Collect Errors (return errors alongside successes).
  • Default Country (required) — Default country for parsing numbers without country code (e.g., US, GB, or Other).
  • Country Code — ISO 3166-1 alpha-2 country code used when Default Country is set to Other.

Output shape

a list of items where each item contains the normalized phone number(s) as per the selected input mode; in Field Mapping and Bullhorn Entity modes, output preserves input JSON with added normalized phone fields; in Manual Input mode, returns array of normalized phone numbers.

Supports processing up to 100 phone numbers per API request. Batch Mode allows grouping multiple input items into fewer API calls. Error handling modes affect whether processing stops or continues on errors and how errors are reported in output. Output fields are named based on input field with a suffix or custom output field name if provided.

Examples

Example 1: Manual Input

User enters one or more phone numbers manually separated by commas; node returns normalized numbers in E.164 format.

Example 2: Field Mapping

User maps an input field (e.g., 'phone') with phone numbers; node adds normalized phone number to output JSON in specified output field or source field name with suffix.

Example 3: Bullhorn Entity

User selects Bullhorn entity type and phone fields; node normalizes each selected phone field in each input item, appending normalized versions to output JSON.

Links

Discussion