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

Syncing Perkville leads

When a referred friend claims a referral offer, Perkville can push the referred prospect to HubSpot as a contact when a HubSpot referral-lead sync is configured.

For the overall referral-to-CRM flow and supported destination examples, see Referral lead syncs.

How to set this up

Reach out to support@perkville.com to request a referral lead sync to your HubSpot account.

A referral being created in Perkville does not automatically create a HubSpot contact. The HubSpot lead sync is a separate integration workflow and is typically triggered when the referred friend claims the referral offer.

Mapped data

Identity

Email is the primary identifier in both HubSpot and Perkville. Email address is used to determine if the referred lead already exists in HubSpot or not. The default behavior of Perkville's HubSpot integration is to not update existing contacts, only create new contacts.

Properties

By default, the following properties are synced over to HubSpot for the referred lead:

  • First Name

  • Last Name

  • Email

  • Phone (if provided)

You can require a phone number when a referred friend claims your referral offer.

Suggested custom properties

These need to be added as contact properties in HubSpot.

  • Referrer email referrer_email

    • Email can be used in a HubSpot workflow to associate the referred lead contact to the referrer contact

  • Referral location referral_location

    • This can either be the location name or the location ID in your membership/POS system

  • Referral sent timestamp referral_sent_timestamp

  • Referral claimed timestamp referral_claimed_timestamp

Last updated

Was this helpful?