Getting Started with Friendbuy
Referral Program Placements
Friendbuy Referral Emails
Driving Referral Program Awareness
Referral Offer Strategies
Limited-Time Offer Promotions in Referral
Referral Contests, Sweepstakes and Giveaways
A/B Testing Best Practices
How can I invite my team to the Friendbuy platform?
Managing Your Account Settings
How to Set Up and Change Your Email Sender
Referral Campaign Management
How to Create a New Theme
How to Make Changes to a Theme
How to Apply Theme Changes to a Widget
How to update a Widget or Theme to the latest version
How to Set Up a Ribbon
How to Set Up an Advocate Landing Page
How to Set Up a Friend Landing Page
How to Set Up a Post-Purchase Overlay
How to Set Up an Account Page Widget
How to configure your Terms & Conditions
How to Test a Widget
How to Set up a Self-Referral Overlay
How to Create a New Referral Campaign
How to set up Referral Code Personalization for PURLs
Setting Up an Advocate Reward
Setting Up a Friend Incentive
Setting Up Shopify Coupon Code Integration
How to Run an A/B Test
How to Change Your Referral Offer
Setting Up Max Clicks for Referral Links
How to Generate Personalized URLs (PURLs) through Our API
How to Generate Personalized URLs (PURLs) for Advocates
How to Configure Tiered Rewards
How to Archive a Referral Campaign
How to Create a New Code Bank
How to Generate Coupons in Bulk for Shopify
Setting Up Low Code Bank Notifications
How to Add Codes to an Existing Code Bank
Trigger a Direct Mail Campaign to Drive Referral Program Awareness (Friendbuy x Iterable x Poplar)
Send a Triggered Text to Prompt a Referral After a Positive Review with Attentive and Okendo
Automatically Prompt a Referral Post Purchase in Attentive
How to send Referral Links Post Product Review (Yotpo)
How to Prompt a Referral After a Positive Review with Friendbuy and Trustpilot (via Klaviyo)
How to send one time emails with referral links through Klaviyo
How to Send Referral Links Post Positive Product Review (Okendo)
Send Referral Program Text Messages Through Attentive
How to Leverage Friendbuy with Kustomer
How to Send Referral Links Post Purchase through Klaviyo
How to Text Coupon Codes to Advocates using Attentive Journeys
Make it Easy for Advocates to Refer by Sending Their PURL Through SMS using Attentive Journeys
How to Send Advocates a Reminder Text to Redeem Their Coupon Codes through Attentive Journeys
How to Send Referred Friends a Reminder Text to Redeem Their Coupon Codes through Attentive Journeys
How to Send a Coupon Code to a Referred Friend using Attentive Journeys
Increase Referral Program Awareness with a Dedicated Email Blast through Iterable Journeys
How to Enable the Klaviyo Integration
How to Leverage the Friendbuy and Ethyca Integration
How to Enable the Iterable Integration
How to Leverage Friendbuy With ReCharge
How to Enable the Cordial Integration
How to Integrate Friendbuy with CartHook
How to Enable the Tremendous Integration
How to Enable Friendbuy's integration with Recharge
How to set up the Segment Web-Mode (Destination Actions) Integration
How To Enable the Attentive Integration
How to Leverage the Friendbuy x DataGrail Integration
How to Block a Referral Code
How to Block an Email Address
Fraud Settings and Business Rules
Configuring a Global Reward Allowance
Configuring a Referral Link Fallback URL
How to set up expiration for Account Credit or Points
How the Similar Email Address Fraud Check Works
Customer Service Portal
How do I check the status of a referral?
How to Manually Add or Remove Credit / Points to a Customer's Account
Why was my customers reward rejected?
The Referred Friend put in their email address but didn’t get their coupon code. How do I find this?
Resend Reward Email
Override a Rejected or Pending reward
How to Search for a Customer Profile
How to create a Manual Referral
Why didn't the Advocate receive a Reward for a successful referral?
Reasons for Rejected Advocate Rewards and Friend Incentives
Analytics & Reports
What does Fraud Protection do?
What is a typical referral flow?
How to Apply Theme Changes to a Widget
Difficulty downloading reports after you receive an export email?
What are Fraud Checks, Tier Checks, and Rules Checks in the Rewards Report?
How do I change my password?
What is a self-referral redirect URL?
What do the Reward Statuses and Definitions mean?
How to Create a New Theme
What is a Friend Widget?
How are Conversions Tracked in Friendbuy?
A Glossary of Terms
How long is the Referred Friend attribution window
What are some common scenarios, and how do I troubleshoot them?
Updated by William Harper
While we've already discussed how to generate personal referral links using our platform's built-in feature, in this help article, we'll go over how you can generate PURLs using our API! In order to use our API to generate PURLs, you'll need a few things:
- The email(s) of the customers you'd like to generate PURLs for
- The campaign ID of the campaign you'd like the PURL to be associated with for analytics tracking
- Your Friendbuy account's Private API Keys (if you don't have this, please reach out to your Customer Success Manager or firstname.lastname@example.org)
If you have all of the above items, you're ready to get started! Using a program such as Postman (or any other similiar program), you'll want to create a new POST request to https://mapi.fbot.me/v1/personal-referral-link to create or retrieve the PURL for a given customer.
Next, you'll want to navigate to your Authorization settings, and set the Authorization Type to Bearer Token. Enter your Bearer Token in the Token field.
Now, under the Request Body, you'll want to use the above mentioned email address and campaign ID in order to create the Request Body to send to our endpoint. An example of this would be as follows:
For a full list of available parameters used in generating PURLs through our API, be sure to check out our developer documentation by clicking here.
Once you have all of the above steps completed, you're now ready to generate the PURL and send the request! Click Send, and if all is correct, you should receive a 200 response containing the link unique for that customer, example below:
You've now successfully generated a PURL using our API! For generating multiple PURLs via CSV file upload, we'd recommend using our built-in platform feature for this, which you can read more about by clicking here.
- PURLs will include a randomly generated referral code unless you have set up Referral Code Personalization in your Referral Campaign settings and provided the optional fields (firstName or lastName) as a seed in the CSV file. Example: https://fbuy.io/alias/prefixseed
- If a PURL does not exist for the Advocate associated with the requested campaign, one will be created. If a PURL already exists, the link will remain the same.
- If a PURL already exists for an Advocate when creating a new widget for a new PURL campaign, the Analytics for their PURL will not be tracked in the new widget, and will only be tracked in the original widget.
- You can create an Additional Widget in your campaign to assign for tracking PURL analytics independent of existing widgets. Reach out to your Customer Support Manager to learn more about best practices!