Browse topics and support
Navigation

Topics

Support

Ask AI

Ask a product or setup question without leaving this page.

Need human help?

Still stuck?

If this topic is right but the answer is still missing, move directly into human support.

Book a support call
We will keep the article or page context with your request so support can respond faster.
Back to categories
56 articles in this topic

Integrations

Connect CRMs, webhooks, APIs, and automation tools.

Start here

Best first reads for this topic

FAQs

Quick answers in this topic

IntegrationsFAQ
FAQ: What Intercom permissions does Referral Factory need?

When you connect Intercom to Referral Factory, you’ll be asked to authorize the following permissions on Intercom’s OAuth page:

1 min read
IntegrationsFAQ
FAQ: Why did my Intercom integration disconnect?

This can happen if there's been a change in your Intercom settings, a password reset, or a security update that revokes your Intercom token.

1 min read
IntegrationsFAQ
FAQ: Why aren't my referrals being auto-qualified via Intercom?

If leads are not being automatically qualified via your Intercom integration, there are a few common causes to check.

1 min read
IntegrationsFAQ
FAQ: Why can't I book referral leads in ServiceTitan?

This is typically caused by incomplete field mapping or a missing setup step in the integration settings.

3 min read
IntegrationsFAQ
FAQ: How long does ServiceTitan integration approval take?

Approval typically takes <strong>1–2 business days</strong> after you submit your ServiceTitan Tenant ID.

2 min read
IntegrationsFAQ
FAQ: What is the difference between one-time sync and ongoing sync?

When syncing CRM or payment processor contacts into Referral Factory, you can choose between two sync modes on the confirmation page of the sync wizard:

2 min read
IntegrationsFAQ
FAQ: How does Referral Factory handle duplicate contacts in Intercom?

When Referral Factory sends a new lead or referrer to Intercom, it checks whether a contact with the same email address already exists.

1 min read
IntegrationsFAQ
FAQ: What is the difference between Create New Lead and Create New User in Intercom?

When configuring what happens when a lead or referrer joins your campaign, you’ll see two options for creating contacts in Intercom:

1 min read
IntegrationsFAQ
FAQ: How do I sync my Intercom segments into Referral Factory?

You can sync contacts from Intercom into your campaign as referrers using the Sync wizard.

2 min read
IntegrationsFAQ
FAQ: How do I handle contacts who appear in multiple campaigns in HubSpot?

A single contact can only exist once per campaign.

2 min read
IntegrationsFAQ
FAQ: How do I use Stripe Credits to reward referrers?

Stripe Credits let you reward referrers or referred leads by applying a billing credit to their Stripe account balance.

6 min read
IntegrationsFAQ
FAQ: How do I connect my CRM to Referral Factory?

Referral Factory integrates directly with HubSpot, Salesforce, Intercom, and ServiceTitan. The setup process is similar for each CRM.

3 min read
IntegrationsFAQ
FAQ: Why aren't referral fields populating in Salesforce?

Field population can take up to 30 minutes after a referral event.

1 min read
IntegrationsFAQ
FAQ: When does a referred user get added to ServiceTitan — at signup or when they book a job?

A new booking is created in ServiceTitan as soon as the referred person submits their information on the referral landing page — not when they book a job or.

2 min read
IntegrationsFAQ
FAQ: What Salesforce objects can Referral Factory create, and what fields are required?

Referral Factory can create Lead and Contact objects in Salesforce.

2 min read
IntegrationsFAQ
FAQ: Why are my Tremendous rewards failing?

The two most common causes of failed rewards are insufficient funds in your Tremendous account and a disconnected integration.

2 min read
IntegrationsFAQ
FAQ: How do I connect Tremendous to Referral Factory?

To set up the Tremendous integration, you'll first need a Tremendous account (free to sign up at tremendous.com).

3 min read
IntegrationsFAQ
FAQ: Why does my Tremendous integration keep disconnecting?

Disconnections are uncommon but can happen in a few specific situations:

2 min read
IntegrationsFAQ
FAQ: Why aren't my contacts syncing to HubSpot?

The most common cause is the "Do nothing" setting.

1 min read
IntegrationsFAQ
FAQ: What reward and payout options does Tremendous offer through Referral Factory?

Tremendous is Referral Factory's native reward partner and supports a wide range of payout options including gift cards, prepaid Visa/Mastercard, PayPal, and.

1 min read
IntegrationsFAQ
FAQ: How do I auto-qualify referrals based on a HubSpot deal stage?

In your campaign's HubSpot integration settings, scroll down to the Qualification Rules section. Select the deal stage that should trigger qualification.

1 min read
IntegrationsFAQ
FAQ: How do I set up webhooks?

API access and outbound webhooks are available on the Basic plan and above.

2 min read
IntegrationsFAQ
FAQ: How do I qualify referrals based on a deal stage when I'm creating contacts, not deals?

Referral Factory’s HubSpot integration works within a single object type.

2 min read
IntegrationsFAQ
FAQ: Does Referral Factory automatically remove users who leave an Intercom segment?

No. Referral Factory does not automatically delete referrers when they are removed from an Intercom segment, deactivated, or leave the company.

1 min read
IntegrationsFAQ
FAQ: How do I integrate Referral Factory with Shopify or my e-commerce store?

Referral Factory integrates with e-commerce platforms like Shopify, Wix, and WooCommerce through Zapier, Make, or API/webhooks.

1 min read
IntegrationsFAQ
FAQ: How long does auto-qualification via Salesforce take?

Qualification depends on when Salesforce pings Referral Factory to confirm the status update.

1 min read
IntegrationsFAQ
FAQ: What does the "cannot reference converted lead" error mean in Salesforce?

This error occurs when a Lead in Salesforce has already been converted to a Contact (and sometimes an Account or Opportunity) before the referral sync tries to.

1 min read
IntegrationsFAQ
FAQ: Does Referral Factory work with my e-commerce platform?

Referral Factory works with most e-commerce setups, though the connection method depends on your platform.

1 min read
IntegrationsFAQ
FAQ: Why aren't my HubSpot properties populating in the integration mapping?

If a HubSpot contact property is not appearing in Referral Factory's field mapping dropdown, the most common cause is that the property is not set to Show in.

1 min read
IntegrationsFAQ
FAQ: Which integration should I use for automatic qualification?

Use the integration that records your conversion event most reliably.

2 min read
IntegrationsFAQ
FAQ: How long does it take for my CRM contacts to sync?

Standard syncs (under 1,000 contacts) typically complete within up to 30 minutes.

1 min read
IntegrationsFAQ
FAQ: I connected my CRM but referrals aren't qualifying — what's wrong?

Work through this checklist:

2 min read
More in this category

Additional reference

IntegrationsHow-To
How to connect Intercom to Referral Factory

Connecting Intercom to Referral Factory lets you automatically send new leads and referrers to Intercom, sync Intercom contacts into your campaigns, and.

2 min read
IntegrationsHow-To
Where to find your Campaign ID and API Key

Your Campaign ID and API Key are required for API calls, webhook configuration, and many third-party integrations like Zapier and Make.

2 min read
IntegrationsHow-To
How to send new referrers to Intercom automatically

When a new referrer joins your campaign by signing up for a referral link, you can automatically create a corresponding contact in Intercom.

2 min read
IntegrationsHow-To
How to map fields between Intercom and Referral Factory

When configuring the Intercom integration, you’ll need to map fields between Referral Factory and Intercom.

2 min read
IntegrationsHow-To
How to disconnect Intercom from Referral Factory

If you no longer need the Intercom integration, you can disconnect it from your campaign.

1 min read
IntegrationsHow-To
How to sync Intercom contacts as referrers

You can import contacts from Intercom into your Referral Factory campaign as referrers.

3 min read
IntegrationsHow-To
How to use Zapier with Referral Factory

Zapier lets you connect Referral Factory to 8,000+ other apps using a no-code interface.

3 min read
IntegrationsHow-To
How to use n8n with Referral Factory

n8n is an open-source workflow automation tool that works similarly to Zapier and Make. It can be self-hosted for full data control, or used via n8n Cloud.

3 min read
IntegrationsHow-To
How to use Make (Integromat) with Referral Factory

Make (formerly Integromat) is a visual automation platform that lets you build multi-step workflows — called scenarios — connecting Referral Factory to.

3 min read
IntegrationsHow-To
How to send new leads to Intercom automatically

When a new lead joins your referral campaign, you can automatically create a corresponding contact in Intercom.

2 min read
IntegrationsHow-To
How to connect Salesforce to Referral Factory

Connecting Salesforce lets you automatically send referred leads to Salesforce, sync Salesforce contacts into your campaign as referrers, and qualify referrals.

5 min read
IntegrationsHow-To
How to Connect and Configure Your ServiceTitan Integration

This guide walks you through connecting Referral Factory to ServiceTitan and configuring it to automatically create bookings for referred leads, auto-qualify.

15 min read
IntegrationsHow-To
How to connect Stripe to Referral Factory

Connecting Stripe lets Referral Factory automatically qualify leads when a referred customer makes a payment in Stripe.

3 min read
IntegrationsHow-To
How to Connect and Configure Your HubSpot Integration

This guide walks you through connecting Referral Factory to HubSpot and configuring it to automatically send leads and referrers to your CRM, auto-qualify.

13 min read
IntegrationsHow-To
Referral Factory API — adding referrers via API

Use the API to programmatically enrol users as referrers in your campaign — for example, automatically adding a customer as a referrer the moment they complete.

1 min read
IntegrationsHow-To
Referral Factory API — getting started

The Referral Factory REST API lets you programmatically manage your referral program — adding referrers, qualifying leads, and retrieving campaign data from.

2 min read
IntegrationsConcept
FAQ: What is field mapping: dynamic values vs fixed values

When you configure a CRM integration in Referral Factory, you will encounter field mapping — the process of telling Referral Factory which data to send to your.

3 min read
IntegrationsHow-To
Referral Factory API — qualifying leads via API

Use the qualification endpoint to programmatically mark a lead as qualified from your own system when a conversion event occurs.

1 min read
IntegrationsHow-To
How to Qualify Referrals Automatically Using HubSpot

Once your HubSpot integration is connected, you can set up qualification rules that automatically mark a referral as qualified inside Referral Factory when.

6 min read
Also trending

Across the help hub