API Reference
Start typing to search…

Prepaing your user data

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

The VDP Connect API currently only accepts SHA256 hashed identifiers for email addresses 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
  • Remove all quotation marks and extra spaces inside the email

✅ Example

Raw Email Address: [email protected]

SHA256 Hashed Email: 62b1ab5bc982e80ecf47618d6c3e96368906bbcd6bf3c82b0d872ba80329e363

Use this example to validate your hashing logic and confirm it matches Viant’s expected output before submitting address 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.