← View All Guides
HubSpot logo
Integration Guide

How to Trigger GrowSurf Referrals from HubSpot Deal Stages

Use HubSpot deal-stage referral triggers in GrowSurf so a qualified deal stage can award referral credit without a custom workflow bridge.

Want the full setup walkthrough?

Use these docs for exact setup steps, supported fields, and troubleshooting.

GrowSurf can listen for HubSpot deal stage changes and trigger referral credit when the associated contact's email matches an existing GrowSurf participant.

That makes HubSpot the source of the pipeline signal, while GrowSurf stays responsible for referral attribution, crediting, and reward logic.

Integration Steps

Connect HubSpot and enable the referral trigger

HubSpot referral trigger toggle in GrowSurf
The referral trigger is enabled separately from the basic HubSpot contact-property sync.

In GrowSurf, connect HubSpot and turn on Referral Trigger. You can use the HubSpot sync, the referral trigger, or both together depending on the workflow you need.

Select the HubSpot pipeline and stage that should count

HubSpot pipeline and stage selection in GrowSurf
Choose the pipeline and the exact stage that should signal a qualified referral.

Pick the deal pipeline and stage that represent the real milestone for your referral program. In most teams, that is a stage closer to a qualified or closed outcome, not the first early-stage touchpoint.

Use a hold period if deals often fall through

HubSpot referral trigger hold period settings in GrowSurf
A hold period helps prevent deals that quickly drop back out of the stage from counting as referral wins.

If deals often move backward after entering the selected stage, turn on the advanced hold period settings. GrowSurf will only award the referral if the deal remains in the qualifying stage for the time you choose.

Make sure the associated contact already exists as a GrowSurf participant

HubSpot can only trigger a GrowSurf referral when the associated deal contact can be matched to a participant email GrowSurf already knows. If your campaign does not auto-add participants, make sure your signup flow, JavaScript install, or API integration creates the participant first.

Test the stage change and read the participant activity log

HubSpot sends deal-stage events asynchronously, so do not expect referral credit to appear instantly. Move a test deal into the qualifying stage, then inspect the GrowSurf participant activity log to confirm when the trigger was received and processed.

Tips

Pick a stage that reflects a real business outcome

If the stage is too early, you will award referrals before the opportunity is truly qualified. Use the stage that best represents the point where you want GrowSurf to count the referral.

Keep the deal associated to the right contact

GrowSurf checks the email address on the HubSpot deal's associated contact. If the wrong contact is attached to the deal, the referral trigger can match the wrong participant or fail to match anyone.

Expect a short delay during testing

HubSpot events and GrowSurf queue processing are asynchronous. During testing, give the trigger at least a minute before assuming it failed, then read the participant activity log for the exact result.

FAQ

Do I need a Zap or custom workflow to trigger referrals from HubSpot deals?

No. GrowSurf already supports HubSpot deal-stage referral triggers natively. You choose the qualifying stage in GrowSurf, and GrowSurf handles the referral credit when HubSpot sends the event.

Why didn't the referral fire immediately after the deal changed stage?

HubSpot sends stage-change events asynchronously, and GrowSurf processes them through a queue. A short delay is expected, so check the participant activity log before troubleshooting deeper.

What has to exist before a deal-stage trigger can work?

The associated deal contact must already match a GrowSurf participant email. If your campaign does not auto-add participants, make sure your signup flow or API integration creates the participant record before the deal reaches the qualifying stage.

Set up your refer a friend program with customer referral and affiliate program software that lowers your acquisition costs, increases customer loyalty, and saves you gobs of time.

Trusted by marketing and product teams at fast-growing B2C, fintech, and SaaS companies