For the complete documentation index, see llms.txt. This page is also available as Markdown.

HubSpot

Bring Perkville referrals and loyalty information into HubSpot contacts and workflows.

Integration at a glance

Referrals & rewards

  • Referral leads — Create contacts from Perkville referrals through a configured lead sync.

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

1

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.

2

Authorize the integration

Once registered and signed into Middle, follow these steps:

  1. Click on the “HubSpot” app in the top left corner

  2. Select “Edit Connection Details”

  3. Custom Fields For Contacts: If you would like to sync specific custom fields for Contacts, enter the property "name" here, one per line

  4. 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

  5. Click “Launch OAuth Flow”

  6. 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.

Continue reading

Start with Syncing Perkville leads to explore the detailed guides in this section.

Last updated

Was this helpful?