HubSpot
Bring Perkville referrals and loyalty information into HubSpot contacts and workflows.
Integration at a glance
Data & workflows
Program data — Sync program status, point balance, last earned transaction and challenge participation.
Automation — Use Perkville activity in HubSpot workflows and send program-relevant HubSpot data to Perkville.
Existing contacts — Contact-update behavior depends on the workflow. The default referral-lead flow creates new contacts and does not update existing contacts.
Your configured rules determine which eligible activities award points and which workflows are enabled.
Integration Steps
Account setup in Middle
Your Perkville Customer Success Representative will send you an invitation to our integration platform, Middle.
Follow the link in your invitation email to Middle to complete registration and set your password.
Authorize the integration
Once registered and signed into Middle, follow these steps:
Click on the “HubSpot” app in the top left corner
Select “Edit Connection Details”
Custom Fields For Contacts: If you would like to sync specific custom fields for Contacts, enter the property "name" here, one per line
Custom Fields Prefix for Contact Syncs: If you would like to sync specific custom fields for Contacts based on a prefix, enter the prefix of the properties' names
Click “Launch OAuth Flow”
Follow the prompts to complete authorization
Data mapping for Perkville data
The Perkville team will need to know which Hubspot contacts need to be created or updated by the integration and which properties need to be updated. We'll need the following:
The internal name of the property
The data type of the property (text, number, date, or datetime)
Internal name
Hubspot custom properties allow you to map non-standard data from your source app to Hubspot. Follow the instructions in the linked article to learn how to setup custom fields in your Hubspot instance:
The internal name can be found in your property settings or when you're creating a new property:

Integration guides
FAQ
Does the lead sync update existing contacts?
The default referral-lead workflow creates new contacts only. Other program-data workflows can update properties; agree their matching and update rules separately.
See the HubSpot partner profile for additional integration information.
Last updated
Was this helpful?

