Actions10
- Address Utils Actions
- Address Convert Actions
Address Utils → Normalize
AI-generatedSummary
Normalize an address by standardizing its components (such as state, country, postal code) according to ISO standards and local address conventions, using input in one of three modes: manual entry, Bullhorn entity fields, or parsing a free-form address string.
Inputs
- Authentication — Choose between User Credentials (Email & Password) or Enterprise Credentials (API Key) for Bullhorn API authentication; default is Enterprise.
- Input Mode (required) — Select how to provide the address data: Manual Input (individual fields), Bullhorn Entity (preset Bullhorn entity address fields), or Parse Address String (free-form address).
- Address fields (Manual Input) — Fields such as Address Line 1, Address Line 2, City, State, ZIP/Postal Code, and Country Code are required if manual mode is selected; all are optional strings except country code which should be an ISO 3166-1 alpha-2 code.
- Address String (Parse Address String mode) (required) — A free-form address string to parse into normalized address fields.
- Entity Type (Bullhorn Entity mode) — Specifies the Bullhorn entity type to normalize addresses for, one of Candidate, Client Contact, or Client Corporation.
- Address Fields (Bullhorn Entity mode) — Specify one or both of the Bullhorn address fields ('Primary Address', 'Secondary Address') to normalize.
- Error Handling — Controls behavior on errors during processing: Fail Fast (stop immediately), Continue (skip errors), or Collect Errors (include errors alongside results); default is Fail Fast.
Output shape
Returns normalized address data matching the input address structure or parsed fields, with standardized state, country, postal code, and other components. In Bullhorn entity mode, multiple addresses may be processed according to specified fields.
When using Manual Input, individual fields are normalized; when parsing an address string, the string is parsed and normalized; when using Bullhorn entity mode, specified entity address fields are normalized. Errors are handled according to the chosen error mode. Default country is configurable for normalization when missing or ambiguous.
Examples
Example 1: Normalize a manually entered address
Input Mode set to 'Manual Input'; provide street, city, state, zip, and country code; select error mode as desired.
Example 2: Parse and normalize a free-form address string
Input Mode set to 'Parse Address String'; provide a full address string to parse; specify error handling mode.
Example 3: Normalize addresses from Bullhorn entity data
Input Mode set to 'Bullhorn Entity'; choose entity type and address fields; uses Bullhorn credentials for authentication; normalizes each specified address field.