Skip to main content
All CollectionsIssuing Rewards
Rewards with Referral Factory and Webhooks
Rewards with Referral Factory and Webhooks

Reward referral participants with webhooks 🎁 Connect your program to custom software, apps, or platforms to automate rewards effortlessly!

Updated over 4 months ago

πŸ“Œ Want to know what else you can do with rewards on Referral Factory? Read the overview.


What You Can Do With Webhook Rewards

With Webhooks and Referral Factory, you have the flexibility to reward and incentivize in a way that suits your needs.

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 to reward both users, you will need to add multiple rewards, one for the Person Referring and another for the Person Invited.

What Events Can Trigger A Reward?

You can trigger a reward when:

  • The Person Referring joins your campaign either by registering for a referral link or being added to your campaign. (This reward can only be given to the Person Referring).

  • The Person Invited joins your campaign by filling in their details on the referral link shared with them. (This reward can be given either to the Person Referring or the Person Invited).

  • The Person Invited qualifies. (This reward can be given either to the Person Referring or the Person Invited).

  • All of the above! Note that you will need to add multiple rewards, one for each of the triggers.

In addition, you have the option to trigger rewards:


How To Add A Fixed Amount Reward and Issue it Via A Webhook

Step 1: Add Reward From the Rewards Dashboard

β†’ In the left-hand navigation bar of your Referral Factory dashboard, click the Rewards tab and select Dashboard from the dropdown menu.

β†’ Select the Fixed Amount tab.

β†’ Click Add Reward.

Step 2: Name Your Reward and Link A Campaign

β†’ Name the reward. This is used for internal management purposes and won’t be shown to your users.

β†’ Select the relevant campaign.

β†’ Click Create.

❗️ Rewards are linked to campaigns. If you have multiple campaigns and want to issue rewards in each of them, you will need to create multiple rewards.

Step 3: Choose Who Should Be Rewarded and Select Whether It Should Be Once Off or Recurring

β†’ Choose who should be rewarded: the Person Referring or the Person Invited. If you want to reward both users in the same campaign, you should create multiple rewards.

β†’ Select whether your reward should be issued once off or as a recurring reward.

β†’ Click Next.

Step 4: Select How and When to Issue the Reward

β†’ For the issuing method, select Webhooks.

β†’ Select when you want the reward to be triggered.

β†’ Click Next.

❗️ Since Fixed Amount rewards have a monetary value, they cannot be triggered when the Person Referring joins your campaign or when a Person Invited signs up via a referral link. This protective measure ensures that you only pay rewards for qualified/converted referrals.

Step 5: Set the Currency, Value and Target

β†’ Select the currency and set the value of your reward.

β†’ If applicable, set the target number of referrals or converted referrals that should trigger the reward.

β†’ Click Next.

Step 6: Configure Your Webhook

β†’ Enter the endpoint URL that should receive the webhook.

β†’ Configure your outbound webhook method.

β†’ Optionally, add headers and credentials.

β†’ Structure your data payload.

β†’ Click Next.

Step 7 (Optional): Create an Email Notification

β†’ To trigger an email when a reward is issued, toggle the feature on and use the drag-and-drop builder to edit it. Your email notification will be automatically styled in the design of your campaign.

β†’ Click Next.

πŸ“Œ You can disable or edit this email notification from the Rewards Dashboard by clicking the blue button in the Actions column alongside the relevant reward.

Step 8: Activate Your Reward

β†’ If you would like to automatically issue rewards, toggle on auto-issue. This means you will not have to authorize these rewards to be issued, they will be issued automatically. This method is NOT recommended.

β†’ Set whether you would like to limit the number of rewards that can be issued to any single user. The limit is the number of rewards to be issued, not the value of the rewards.

β†’ Click Activate.

πŸ“Œ Now that you’ve added a reward, learn how to issue rewards that become due.


How To Add A Commission-Based Reward and Issue it Via A Webhook

Step 1: Add Reward From the Rewards Dashboard

β†’ In the left-hand navigation bar of your Referral Factory dashboard, click the Rewards tab and select Dashboard from the dropdown menu.

β†’ Select the Commission tab.

β†’ Click Add Reward.

Step 2: Name Your Reward and Link A Campaign

β†’ Name the reward. This is used for internal management purposes and won’t be shown to your users.

β†’ Select the relevant campaign.

β†’ Click Create.

❗️ Rewards are linked to campaigns. If you have multiple campaigns and want to issue rewards in each of them, you will need to create multiple rewards.

Step 3: Choose Who Should Be Rewarded and Select Whether It Should Be Once Off or Recurring

β†’ Choose who should be rewarded: the Person Referring or the Person Invited. If you want to reward both users in the same campaign, you should create multiple rewards.

β†’ Select whether your reward should be issued once off or as a recurring reward.

β†’ Click Next.

Step 4: Select How and When to Issue the Reward

β†’ For the issuing method, select Webhooks.

β†’ Select when you want the reward to be triggered.

β†’ Click Next.

❗️ Since Commission-based rewards have a monetary value, they cannot be triggered when the Person Referring joins your campaign or when a Person Invited signs up via a referral link. This protective measure ensures that you only pay rewards for qualified/converted referrals.

Step 5: Set the Percentage and, Optionally, the Maximum Value

β†’ Set the percentage of your commission-based reward.

β†’ Optionally, set the currency and maximum value that any individual reward can reach, no matter the total spend of the Person Invited.

β†’ Click Next.

Step 6: Configure Your Webhook

β†’ Enter the endpoint URL that should receive the webhook.

β†’ Configure your outbound webhook method.

β†’ Optionally, add headers and credentials.

β†’ Structure your data payload.

β†’ Click Next.

Step 7 (Optional): Create an Email Notification

β†’ To trigger an email when a reward is issued, toggle the feature on and use the drag-and-drop builder to edit it. Your email notification will be automatically styled in the design of your campaign.

β†’ Click Next.

πŸ“Œ You can disable or edit this email notification from the Rewards Dashboard by clicking the blue button in the Actions column alongside the relevant reward.

Step 8: Activate Your Reward

β†’ If you would like to automatically issue rewards, toggle on auto-issue. This means you will not have to authorize these rewards to be issued, they will be issued automatically. This method is NOT recommended.

β†’ Set whether you would like to limit the number of rewards that can be issued to any single user. The limit is the number of rewards to be issued, not the value of the rewards.

β†’ Click Activate.

πŸ“Œ Now that you’ve added a reward, learn how to issue rewards that become due.


How To Add A Coupon Reward and Issue Via A Webhook

Step 1: Generate A Batch of Unique Coupon Codes in the App Where Your Customers Checkout

β†’ Use your point of sale software, billing software, or e-commerce store to generate a batch of unique coupon codes, which can include any combination of letters and numbers. Ensure you create enough codes to be issued as rewards to your qualifying users. You will be notified when 85%, 95%, and 100% of your coupon codes have been issued. Additional codes can be uploaded later.

β†’ Export your coupon codes as a CSV file. Download a sample CSV file.

Step 2: Add Reward From the Rewards Dashboard in Referral Factory

β†’ In the left-hand navigation bar of your Referral Factory dashboard, click the Rewards tab and select Dashboard from the dropdown menu.

β†’ Select the Coupon tab.

β†’ Click Add Reward.

Step 3: Name Your Reward and Link A Campaign

β†’ Name the reward. The name is used for internal management purposes and won’t be shown to your users.

β†’ Select the relevant campaign.

β†’ Click Create.

❗️ Rewards are linked to campaigns. If you have multiple campaigns and want to issue rewards in each of them, you will need to create multiple rewards.

Step 4: Choose Who Should Be Rewarded

β†’ Choose who should be rewarded: the Person Referring or the Person Invited. If you want to reward both users in the same campaign, you should create multiple rewards.

β†’ Note that coupon rewards can only be issued once-off. Should you wish to issue a recurring reward, please select a Fixed Amount, Commission, or Custom reward.

β†’ Click Next.

Step 5: Select How and When to Issue the Reward

β†’ For the issuing method, select Webhooks.

β†’ Select when you want the reward to be triggered.

β†’ Click Next.

Step 6: Finalize Your Rules

β†’ Review the rules you’ve set so far.

β†’ Click Next.

Step 7: Upload and Style Your Coupons

β†’ Upload the CSV file of coupon codes you created in Step 1. Alternatively, you can copy and paste the codes manually.

β†’ Style the look and feel of your coupon codes. These can be inserted into email notifications and pages for the Person Referring and the Person Invited. You can also edit the style of your coupon at a later stage from inside your campaign builder.

Step 8: Configure Your Webhook

β†’ Enter the endpoint URL that should receive the webhook.

β†’ Configure your outbound webhook method.

β†’ Optionally, add headers and credentials.

β†’ Structure your data payload.

β†’ Click Next.

Step 9 (Optional): Configure Your Reward Email Notification

β†’ Should you wish to trigger an email when a reward is issued, toggle the feature on and use the drag-and-drop builder to edit it. Your email notification will be automatically styled in the design of your campaign and will issue a unique coupon code to each reward recipient.

β†’ Click Next.

πŸ“Œ You can disable or edit this email notification from the Rewards Dashboard by clicking the blue button in the Actions column alongside the relevant reward.

πŸ“Œ You can also insert coupons into other email notifications, for example, the email notification for the Person Invited when they join your campaign.

Step 10: Activate Your Reward

β†’ If you would like to automatically issue rewards, toggle on auto-issue. This means you will not have to authorize these rewards to be issued, they will be issued automatically. This method is NOT recommended.

β†’ Set whether you would like to limit the number of coupons that can be issued to any single user. The limit is the number of coupons to be issued, not the value of the reward.

β†’ Click Activate.

πŸ“Œ Now that you’ve added a reward, learn how to issue rewards that become due.


How To Add A Custom Reward and Issue It Via A Webhook

Step 1: Add Reward From the Rewards Dashboard in Referral Factory

β†’ In the left-hand navigation bar of your Referral Factory dashboard, click the Rewards tab and select Dashboard from the dropdown menu.

β†’ Select the Custom tab.

β†’ Click Add Reward.

Step 2: Name Your Reward and Link A Campaign

β†’ Name the reward. The name is used for internal management purposes and won’t be shown to your users.

β†’ Select the relevant campaign.

β†’ Click Create.

❗️ Rewards are linked to campaigns. If you have multiple campaigns and want to issue rewards in each of them, you will need to create multiple rewards.

Step 3: Choose Who Should Be Rewarded

β†’ Choose who should be rewarded: the Person Referring or the Person Invited. If you want to reward both users in the same campaign, you should create multiple rewards.

β†’ Select whether your reward should be issued once off or as a recurring reward.

β†’ Click Next.

Step 4: Select How and When to Issue the Reward

β†’ For the issuing method, select Webhooks.

β†’ Select when you want the reward to be triggered.

β†’ Click Next.

Step 5: Specify the Quantity, Reward Type and Target

β†’ Set the quantity and type of reward you wish to issue. For example, you might reward someone with 50 points, 1 branded coffee mug, or 10 tokens.

β†’ If applicable, set the target number of referrals or converted referrals that should trigger the reward.

β†’ Click Next.

Step 6: Configure Your Webhook

β†’ Enter the endpoint URL that should receive the webhook.

β†’ Configure your outbound webhook method.

β†’ Optionally, add headers and credentials.

β†’ Structure your data payload.

β†’ Click Next.

Step 7 (Optional): Create an Email Notification

β†’ To trigger an email when a reward is issued, toggle the feature on and use the drag-and-drop builder to edit it. Your email notification will be automatically styled in the design of your campaign.

β†’ Click Next.

πŸ“Œ You can disable or edit this email notification from the Rewards Dashboard by clicking the blue button in the Actions column alongside the relevant reward.

Step 8: Activate Your Reward

β†’ If you would like to automatically issue rewards, toggle on auto-issue. This means you will not have to authorize these rewards to be issued, they will be issued automatically. This method is NOT recommended.

β†’ Set whether you would like to limit the number of rewards that can be issued to any single user. The limit is the number of rewards to be issued, not the quantity you set in Step 5.

β†’ Click Activate.

πŸ“Œ Now that you’ve added a reward, learn how to issue rewards that become due.

Did this answer your question?