Email, Phone Number and Physical Address Hashing Requirements (No hashing needed for IP, MAID & Cookies)

The VDP Connect API currently only accepts SHA256 hashed identifiers for email addresses, phone number and physical addresses. To ensure compatibility with Viant’s matching system, all values must be properly formatted and hashed before upload.

Use the guidance below to format raw inputs and verify your hashing logic using the provided test examples.

Email Address SHA256 Hashing

To ensure consistent hashing, follow these formatting rules before hashing the email:

Convert all letters to lowercase
Remove any leading/trailing white spaces
Do not include friendly names
- ✅ jdoe@viantinc.com
- ❌ <John Doe> jdoe@viantinc.com
Remove all quotation marks and extra spaces inside the email

✅ Example

Raw Email Address: joe@gmail.com

SHA256 Hashed Email: 62b1ab5bc982e80ecf47618d6c3e96368906bbcd6bf3c82b0d872ba80329e363

Use this example to validate your hashing logic and confirm it matches Viant’s expected output before submitting email data to the API.

Phone Number SHA256 Hashing

To ensure consistent hashing, follow these formatting rules before hashing the phone number:

Remove the country code (U.S. numbers should be 10 digits only)
Remove all symbols, including:
- Hyphens -
- Parentheses ()
- Spaces
Do not include any extensions
The final value must be exactly 10 digits, numeric only

✅ Example

Raw Phone Number: +1(111)-222-3456 Preprocessed Phone Number: 1112223456 SHA256 Hashed Phone Number: 685a056dcbc4012d77226d151ffcae117b0affaf8435a5e25698dc7511dd19dd

Use this example to validate your hashing logic and confirm it matches Viant’s expected output before submitting phone number data to the API

Physical Address SHA256 Hashing

Before hashing, format physical addresses using the following standardized formatting rules:

General Formatting

Use postal service standards for structure and punctuation
Use one space between each address component
Remove any leading/trailing white space
Use proper capitalization:
- Street/city/country names: Capitalize first letter of each word
- State: Use 2-letter uppercase abbreviation
- Zip code: Pad to 5 digits (e.g., 9123 → 09123)
- Country: USA

Comma Usage

Include commas between:
- Street address and city
- City and state/zip
- State/zip and country
Do not include a comma between street name and unit (e.g., St #37a)

Unit Numbers

Use # followed by the unit number or letter
Unit letters should be lowercase (e.g., #37a)

Street and Compass Abbreviations

Use USPS-standard abbreviations, capitalize only the first letter:
- Street → St, Lane → Ln, Boulevard → Blvd, Drive → Dr
- North → N, South → S, East → E, West → W

✅ Example

Raw Address: 1465 N Larrabee St #37a, Chicago, IL 60610, USA

SHA256 Hashed Address: 0b44cd3d5dec48d40804354442457ade74dd4da194a4a4006f412201ed718b96

Use this example to validate your hashing logic and confirm it matches Viant’s expected output before submitting address data to the API.