Overview
This guide walks you through creating custom Contact properties in HubSpot that enable Knock2 to track custom attribution and engagement events.
Once created, these properties allow Knock2 to automatically record when and how contacts were created or enriched, along with behavioral data like page visits.
Note: Knock2 will automatically populate these properties if they exist.
If they don’t, Knock2 will still function normally — these properties simply enhance your data tracking.
Step 1: Create Custom Properties in HubSpot
Go to Settings → Properties → Contact Properties, and create the following six properties. All properties should be created under the Contact object type. Internal names must match exactly.
1. knock2_attributed
Label: Knock2 Attributed
Description: Indicates if this contact was created or enriched by Knock2
Field Type: Single checkbox
Internal Name:
knock2_attributed
2. knock2_origin
Label: Knock2 Origin
Description: How Knock2 interacted with this contact
Field Type: Dropdown select
Internal Name:
knock2_originOptions:
created_by_knock2– Created by Knock2enriched_by_knock2– Enriched by Knock2
3. knock2_first_seen_at
Label: Knock2 First Seen At
Description: First time Knock2 interacted with this contact
Field Type: Date and time picker
Internal Name:
knock2_first_seen_at
4. knock2_last_activity_at
Label: Knock2 Last Activity At
Description: Most recent Knock2 touch (create or enrich)
Field Type: Date and time picker
Internal Name:
knock2_last_activity_at
5. knock2_page_count
Label: Knock2 Page Count
Description: Total number of pageviews detected by Knock2
Field Type: Number (Unformatted)
Internal Name:
knock2_page_count
6. knock2_last_pages
Label: Knock2 Last Pages
Description: List of most recent pages visited by this contact
Field Type: Multi-line text
Internal Name:
knock2_last_pages
Step 2: Configure in HubSpot
In HubSpot, click the ⚙️ Settings icon (top-right).
Go to Data Management → Properties → Contact Properties.
Click Create property and enter the details above.
For dropdowns (
knock2_origin), add the specified options.Click Create and repeat for all six properties.
Tip: You can search “knock2” in your Properties list afterward to confirm all six are added.
Step 3: Add to Contact Views
Once your properties are created:
Go to Contacts → Actions → Edit columns
Search “knock2” and check all six boxes
Save your layout so these columns appear in your table view
How It Works
When Knock2 Creates a New Contact
Knock2 automatically sets:
Property | Example Value |
| ✅ true |
|
|
|
|
| same as above |
|
|
|
|
When Knock2 Enriches an Existing Contact
Knock2 automatically updates:
Property | Example Value |
| ✅ true |
|
|
| new timestamp |
| updated number |
| latest pages visited |
Note: knock2_first_seen_at is only set at the first creation event — not during enrichments.
Step 4: Verify Setup
Check Properties Exist
Go to Settings → Properties → Contact Properties
Search for “knock2”
Test with a Contact
Wait for Knock2 to create/enrich a contact
Open it in HubSpot → Contact Information section
Confirm Knock2 fields are populated
View Across Contacts
Go to Contacts → Contacts
Edit columns to include Knock2 fields
Now you can sort, filter, and view attribution data
Step 5: Reporting & Segmentation
Use these properties to create reports or active lists in HubSpot:
Example 1: Contacts Created by Knock2
Filter → knock2_attributed is true
Example 2: Recent Knock2 Activity
Filter → knock2_last_activity_at is within last 7 days
Troubleshooting
Properties Not Being Populated
Double-check internal names match exactly
Confirm all six properties exist
Ensure Knock2’s HubSpot integration has write permissions
Properties Blank or “Unknown”
Normal for older contacts created before setup
Only new or updated contacts after property creation will show values
Need Help?
If you run into issues or want Knock2 Support to verify your setup, reach out via chat or email.
Support Email: support@knock2.ai