Intent Signals

Preparing to Receive Signals

You will need to prepare the following:

• A file/list of email md5s (email addresses in all lower-case, hashed using md5)

• Your API endpoint and field names (instructions for where we should POST your signals - see available fields below)

• Any type of criteria you want to provide (specific categories, channels, etc)

Receiving Signals

Our team will supply you with the following:

• Credentials for an S3 bucket to upload your md5 match file

• API instructions to continually update your md5s in real-time

Available Fields

Field Name	Description
email	email address*
email_md5	md5 hash of lowercase email address
email_sha1	sha1 hash of lowercase email address
email_sha256	sha256 hash of lowercase email address
email_domain	email_domain (example: gmail.com)
first_name	First Name*
middle_initial	Middle Initial*
middle_name	Middle Name*
last_name	Last Name*
birth_date	Date of Birth*
city	City Name
region	State (example: california)
region_code	State Code (example: ca)
country	Country (example: united states)
country_code	Country Code (example: us)
street_address	Street Address*
address_line_2	Street Address 2*
postal_code	Postal Code (Example: 90405)
postal_code_ext	Postal Code Extension (+4)
categories	Historical categories (Taxonomy)
ip	IP Address (Example: 192.168.1.100)
ip_city	IP Address City (Example: los angeles)
ip_region	IP Address Region (Example: california)
ip_region_code	IP Address Region Code (Example: ca)
ip_country	IP Address Country (Example: united states)
ip_country_code	IP Address Country Code (Example: us)
ip_postal_code	IP Address Postal Code (Example: 90405)
ip_timezone	IP Address Time Zone (Example:)
ip_connection_isp	IP Address Connection ISP (Example:)
ip_connection_type	IP Address Connection Type (Example:)
locale	Locale (example: en-US)
page_search	Search String (Example: ?utm_medium=news&utm_source=article01&fbclid=...)
received_at	Date/Time Received (Example: 2024-02-21T21:57:58.832Z)
timezone	Timezone
user_agent	Full user_agent string (Example: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36)
user_agent_browser	user_agent: Browser (Example: chrome)
user_agent_browser_version	user_agent: Browser Version (Example: 121)
user_agent_device	user_agent: Device (Example: galaxy)
user_agent_type	user_agent: Type (Example: phone)
user_agent_vendor	user_agent: Vendor (Example: samsung)
user_agent_mobile	user_agent: Mobile (Example: true/false)
user_agent_platform	user_agent: Platform (Example: android)
user_agent_platform_version	user_agent: Platform Version (Example: 12)