GrowSurf Docs
Help CenterSystem StatusContact SupportYour Dashboard →
  • Welcome
  • Getting Started for Web
    • Google Tag Manager
    • Participant Auto Authentication
  • Getting Started for Native Mobile
  • Developer Tools
    • Embeddable Elements
    • JavaScript SDK
      • Tutorials
      • Single Page Applications
      • API Reference
    • REST API
      • Tutorials
      • Objects
      • API Reference
      • API Guidelines
      • API Response Codes
    • Webhooks
      • Securing Your Webhooks (optional)
      • Examples
      • Events Reference
    • Metadata
  • Integrations
    • ActiveCampaign
      • Tutorials
    • Amplitude
    • AWeber
      • Tutorials
    • Brevo (formerly Sendinblue)
      • Tutorials
    • Cal.com
    • Calendly
    • Campaign Monitor
      • Tutorials
    • Chargebee
    • Constant Contact
      • Tutorials
    • ConvertKit
      • Tutorials
    • Customer.io
      • Tutorials
    • Drip
      • Tutorials
    • EmailOctopus
      • Tutorials
    • Fullstory
    • GetResponse
      • Tutorials
    • Google Ads
    • Google Analytics
    • Heap
    • Help Scout
    • HubSpot
      • Tutorials
    • Intercom
      • Tutorials
    • Klaviyo
      • Tutorials
    • LinkedIn Ads
    • Mailchimp
      • Tutorials
    • MailerLite
      • Tutorials
    • Mailjet
      • Tutorials
    • Make
      • Tutorials
    • Marketo
      • Tutorials
    • Meta (Facebook) Ads
    • Mixpanel
    • Pabbly Connect
      • Tutorials
    • PayPal
    • Pendo
    • PostHog
    • Recurly
    • Salesforce
      • Tutorials
    • Segment
    • SendGrid
      • Tutorials
    • Slack
    • Stripe
    • Tango Card
    • Typeform
    • X (Twitter) Ads
    • Zapier
      • Tutorials
      • Using Filters
      • Troubleshooting
Powered by GitBook
On this page
  • Referral Trigger
  • Description
  • How to Set Up
  • Troubleshooting Tips
  • Sync Data
  • Description
  • How to Set Up
  • Examples
  • Contact Properties
  • Troubleshooting Tips

Was this helpful?

  1. Integrations

HubSpot

Trigger referrals on HubSpot deal stage changes and update/add HubSpot contacts with their unique share link and referrer information.

Last updated 3 months ago

Was this helpful?

Note: The Hubspot integration is only available to users on a GrowSurf paid plan.

Referral Trigger

Description

When you connect your HubSpot account to your GrowSurf campaign and enable Referral Trigger, GrowSurf will automatically detect and trigger referrals on HubSpot deal stage changes.

GrowSurf will check if the HubSpot deal's associated contacts' email addresses match a GrowSurf participant's email address. If a match is found, then a referral will trigger, giving referral credit to the referrer and unlocking any rewards, if applicable. If a referral has already been triggered (and referral credit already was awarded), then nothing else will happen because referral credit can only be awarded once.

Here's how to set up HubSpot referral triggers:

How to Set Up

Important Note: Unless your campaign is configured to add participants automagically (), you'll need to make sure you first call JavaScript or REST API to add new participants.

Step 1: In Campaign Editor > 4. Options > Integrations, click the Connect to HubSpot button.

Step 2: Once connected, toggle the switch to enable the Referral Trigger.

Step 3: Select a HubSpot pipeline, then select a deal stage.

(Optional) Step 4: You can add a referral trigger hold period by toggling the Show advanced settings section.

Note: The referral trigger hold period is useful for making sure that deals that fall through do not count as referrals. During this hold period, if a deal does not retain the stage you selected, the referral trigger will be canceled completely.

Troubleshooting Tips

  • When testing out the HubSpot Referral Trigger integration, make sure to view participants' activity logs for details that can help you troubleshoot any issues.

  • HubSpot events (e.g. changing of a stage in a deal) that are sent to GrowSurf are sent asynchronously and could take up to one minute or longer depending on load. Until the event is received GrowSurf cannot process the event and trigger the referral. Furthermore, we use a message queue to process these events. If you do not see a referral trigger right away please be patient.

Sync Data

Description

When new GrowSurf participants are added to your campaign, they will automatically be added/updated as HubSpot contacts with a new property group GrowSurf. Their unique share link and referrer information will be available for use in emails and reports.

How to Set Up

Step 1: In Campaign Editor > 4. Options > Integrations, click the Connect to HubSpot button

Step 2: Choose a HubSpot account

Once you have successfully connected to HubSpot, GrowSurf will automatically create a new contact property group called GrowSurf in your HubSpot account that contains new contact properties (see image below). You can confirm these contact properties in the Settings > Contact Properties page in your Hubspot account.

Examples

Contact Properties

GrowSurf will automatically create these new contact properties for your HubSpot contacts.

Contact properties

Field type

Type

Description

Example

GrowSurf Share URL

Single-line text

text

The participant's unique Share URL (contains their unique GrowSurf ID)

https://piedpiper.com?grsf=d77a8j

GrowSurf Participant ID

Single-line text

text

The participant's unique GrowSurf ID

d77a8j

GrowSurf Referral Status

Single-line text

text

The referral status of the participant*

CREDIT_PENDING

GrowSurf Referrer Email

Single-line text

text

The email of the participant's referrer

gavin@hooli.com

GrowSurf Referrer First Name

Single-line text

text

The first name of the participant's referrer

Gavin

GrowSurf Referrer Last Name

Single-line text

text

The last name of the participant's referrer

Belson

GrowSurf Participant First Name

Single-line text

text

The participant's First Name

Bob

GrowSurf Participant Last Name

Single-line text

text

The participant's Last Name

Loblaw

GrowSurf Total Referral Count

Number

number

The participant's all-time referral count

0

GrowSurf Monthly Referral Count

Number

number

The participant's current month referral count

19

GrowSurf

Prev Monthly Referral Count

Number

number

The participant's previous month referral count

200

GrowSurf Next Milestone

Single-line text

text

You are only 2 referrals away from winning a free t-shirt!

GrowSurf Next Monthly Milestone

Single-line text

text

You are only 2 referrals away from winning a free t-shirt!

GrowSurf Total Invite Count

Number

number

The participant's all-time invite count

112

GrowSurf Total Impression Count

Number

number

The participant's all-time impression count

150

*GrowSurf Referral Status can be the following: CREDIT_PENDING (This participant must still trigger a referral for their referrer to receive referral credit), CREDIT_AWARDED (This participant triggered a referral and their referrer received referral credit), CREDIT_EXPIRED (This participant did not trigger the referral credit within the referral credit expiration window so their referrer did not receive referral credit).

Troubleshooting Tips

  • If the new participant isn't being added to HubSpot, or if they are being added but their unique referral link isn't being synced to HubSpot:

    • Activity logs will denote if a participant was added to HubSpot or if they failed to be added. (In the case of failure, GrowSurf will re-attempt to add them for 7 days).

  • If a Hubspot contact has multiple email addresses, GrowSurf will only sync participant data to one HubSpot contact:

    • Each of your HubSpot contacts is uniquely identifiable by their primary email address. Similarly, all GrowSurf participants are uniquely identified by their email address. When GrowSurf adds a new primary contact or updates an existing primary contact within your Hubspot account, only the email address associated with the GrowSurf participant will be updated, reflecting their GrowSurf participant information.

IMPORTANT: Because the GrowSurf data sync to HubSpot only occurs after you have connected with the integration, it is imperative to connect with the integration BEFORE importing participants. to see remedy options if you have already imported participants into your campaign but would like to sync their GrowSurf data to HubSpot.

to see different kinds of examples that you can copy/paste into your email templates.

The text for the next/upcoming milestone reward (only applies to milestone rewards. )

The text for the next/upcoming monthly milestone reward (only applies to milestone rewards. )

* HubSpot has rate limiting in place for all plans. Please make sure that you are not hitting those limits by following their limits. .

Click here
View our HubSpot tutorials
Learn more here
Learn more about Hubspot's property fields here.
See an example here
See an example here
see image
growsurf.addParticipant()
/POST Add Participant