You can use outbound webhooks to effortlessly send referred leads to other applications or databases, as well as trigger rewards. Additionally, you can send an inbound webhook to Referral Factory to qualify referred leads.
π Webhooks are available on the following plans: Basic, Pro, and Enterprise.
Click here for more information on Referral Factory's plans.
What You Can Do With Webhooks on Referral Factory
Referral Factory can send and receive data to and from other applications, software, or databases. Here are some common use cases for webhooks on Referral Factory:
π When you get a new referred lead, we can send all their details, including the details of the person who referred them (outbound)
π When someone registers for their referral link, we can send all their details (outbound)
π When a referred lead converts, you can notify Referral Factory via webhook to automatically qualify them as a successful referral (inbound)
π When a referred user is marked as qualified on our system (manually, via CRM, Zapier API, etc.), we can send their details and or a notification (outbound)
π When either the person referring or the person invited are issued with a reward, we can send all their details or trigger a reward to be automatically applied via webhook (outbound)
Outbound Webhook: Sending User Data from Referral Factory Out
Referral Factory can send data to other applications via an outbound webhook. So, when you get a new user, we can pass that information into your custom CRM, contact database, or app.
The most popular use case for an outbound webhook on Referral Factory is to send the data of new referred leads. In other words, when someone signs up on their friend's referral link, we can send all the related data to an endpoint of your choice. However, we can also send the data of someone who registers for a referral link.
The following events can trigger an outbound webhook from Referral Factory:
π When a new user (Person Referring OR Person Invited) joins your campaign. In other words, when someone registers for a referral link on the Pages for the Person Referring or when someone fills in their details on the Pages for the Person Invited. While this is a rare case, you can also fire a webhook when a user is added via CRM sync, Zapier, or API.
π When a referred user (the person invited) becomes qualified.
To learn how to set up an outbound webhook, see the following article:
Outbound Webhook: Triggering Rewards Via Webhook
With Webhooks and Referral Factory, you have the flexibility to reward and incentivize in a way that suits your needs. Here are some of the options that you will need to consider when creating your reward:
3.1. Who Can You Reward?
You can reward:
π The Person Referring (the person doing the referring, who shares their referral link)
π The Person Invited (the person being referred, who signs up on the referral link they were sent)
π Both! Note that you will need to add multiple rewards, one for the Person Referring and another for the Person Invited.
Click here to learn more about different types of users.
3.2. What Events Can Trigger A Reward?
You can trigger a reward on:
π An invited referral (when the Person Invited fills in their details on their friend's referral link)
π A converted referral (when the Person Invited "qualifies")
π Both! Note that you will need to add multiple rewards, one for each of the triggers.
In addition to these triggers, you have the option to set up:
π A Standard Reward (These typically operate on an ongoing basis with no changes to the reward value as participants accumulate more and more referrals.)
π A Milestone Reward (These allow you to change the value of a reward based on a goal or target number of referrals at various milestones. One common use case of a milestone reward structure is enabling a tiered structure, offering larger incentives as participants rack up more referrals. Click here to learn more.)
To learn how to set up a reward webhook, see the following article:
Inbound Webhook: Qualifying Referred Users
You can use an inbound webhook to allow you to easily qualify your referred users when they convert - simply by sending their unique code to your inbound webhook endpoint.
We created an inbound webhook so that you can easily qualify your referred users once they convert. You do this by sending their unique code to the endpoint given to you in your account. You can access this code by navigating to the Settings tab and selecting Webhooks and API.
To learn how to set up an inbound webhook, see the following article:
How to Test Your Webhook Using webhook.site
If you want to verify that your webhook is configured correctly and see the data being sent from Referral Factory, you can use a webhook testing tool such as webhook.site.
Step-by-Step: Testing with webhook.site
Open webhook.site
Go to https://webhook.site in your web browser. A unique testing URL will be generated for you automatically.Copy your unique webhook URL
On the webhook.site page, copy the generated URL (it will look something likehttps://webhook.site/xxxx-xxxx-xxxx).Paste into Referral Factory
In your Referral Factory webhook setup, paste the webhook.site URL as the destination URL for your outbound webhook.Trigger the webhook event
Perform the action in Referral Factory that should trigger the webhook (for example, creating or qualifying a referral).View the request in webhook.site
Return to webhook.site and refresh the page. You should see one or more incoming requests β click on them to inspect the payload, headers, and structure of the data that Referral Factory is sending.
Why This Is Useful
Testing with webhook.site allows you to:
Confirm that the webhook is firing correctly
See exactly what data Referral Factory is sending
Validate the webhook payload structure before connecting to your live endpoint
Troubleshoot and debug without impacting your production systems
β
