Getting Started with Friendbuy
Best Practices
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
Account Management
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
Widgets
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 Personalize Your Widgets with the Advocate name
Campaign Settings
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 Duplicate Your Campaign
How to Set Up a Redirect for Limited Time Campaigns
Code Banks
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
Emails
Email Types for Your Referral Program
How to Add DNS Records for Email Sender Verification
How to Create, Edit, and Manage Emails
How to set up an Expiration Reminder email
How to Assign an Email to a Campaign
Code Based Sharing
Integrations
Recharge Integration
Ethyca Integration
Klaviyo Integration
How to send Referral Links Post Product Review (Yotpo + Klaviyo)
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 + Klaviyo)
How to Send Referral Links Post Purchase through Klaviyo
How to Enable the Klaviyo Integration
How to Send a a Customer their Loyalty Points Balance Through Klaviyo
How to Email Coupon Codes Through Klaviyo to Advocates and Friends After They Are Distributed by Friendbuy
How to Reward Customers for Providing a Review Through Yotpo via Klaviyo Through Your Loyalty Program
Upgrading to Klaviyo OAuth with your Friendbuy Integration
How to Reward Customers for Providing a Review Through Okendo via Klaviyo Through Your Loyalty Program
How to Send Coupon Codes through Klaviyo SMS to Advocates and Friends After They are Distributed by Friendbuy
How to Reward Customers For Subscribing to Klaviyo Emails and Texts Through Your Loyalty Program
How to Segment Customers Based on Tier Status in Klaviyo
How to Reward Customers for Providing a Review Through Stamped via Klaviyo Through Your Loyalty Program
Braze Integration
DataGrail Integration
Tango Card Integration
Cordial Integration
Segment Integration
How to Integrate Friendbuy as a Segment Source
How to set up the Segment Web-Mode (Destination Actions) Integration
Tremendous Integration
Iterable Integration
Trigger a Direct Mail Campaign to Drive Referral Program Awareness (Friendbuy x Iterable x Poplar)
How to Enable the Iterable Integration
Increase Referral Program Awareness with a Dedicated Email Blast through Iterable Journeys
Attentive Integration
Send a Triggered Text to Prompt a Referral After a Positive Review with Attentive and Okendo
Automatically Prompt a Referral Post Purchase in Attentive
Send Referral Program Text Messages Through Attentive
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 reward Loyalty Members for signing up for Attentive text messages and emails
How to Include a Customer's Loyalty Points Balance in an Attentive Text
How to Send a Coupon Code to a Referred Friend using Attentive Journeys
How To Enable the Attentive Integration
Fivetran Integration
How to Leverage Friendbuy with Kustomer
Fraud Prevention
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
Performance Overview
Reports
Top Advocates Report
Account Credit or Points Statement Export
Exporting Reports from Friendbuy
Emails Report
Advocate Rewards Report
Purchases Report
The Channel Analytics Dashboard
Friend Incentives Report
Understanding the Codes Report
Dashboards
Common FAQs
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?
Developer Documents
Loyalty Program Management
- All Categories
- Integrations
- Braze Integration
- How To Enable The Braze integration
How To Enable The Braze integration
Updated
by Connor Fotsch
Leverage the integration between Friendbuy and Braze to expand your email and SMS capabilities while effortlessly automating your referral and loyalty program communications. Braze will generate customer profiles for all the opted-in phone numbers collected via Friendbuy.
Installation Instructions
- You'll need your Rest EndPoint. This can be found by going to Braze > Resources > Documentation & User Guides > API > API Overview. Use the correct REST endpoint based on which instance you are provisioned to. If you are unsure, open a support ticket or use the table provided on the API overview page to match the URL of the dashboard you use to the correct REST Endpoint.
- Confirm your API-Key. In your Braze account, go to Settings > API Keys. A REST API key is required with every request to the Braze API. The API Key gives you access to your data for a workspace.
- Log into your Friendbuy account and go to Developer Center > Integrations tab > click on Add integration on the Braze integration card.
- Paste your REST Endpoint, and your API Key in the provided fields.

- Click Install Integration....
- Go back into your Friendbuy account and refresh the page to confirm the Braze integration has been successfully installed. A blue checkmark and success message will appear on the card confirming installation.
How customer data is sent to Braze
Customer data collected in your referral program will be added to the respective Braze profile after a customer interacts with your referral program widgets. Important to note, customer data will only be sent to Braze if the customer opts-in through the referral widget by selecting the opt-in boxes.
For example, if a customer enters both their email and phone number in the widget but only checks the opt-in box for SMS marketing (and leaves the email marketing opt-in box unchecked), then only the phone number will be sent to Braze. If a customer submits their contact information without either opt-in box checked, customer data will not be sent to Braze since consent was not collected.
The opt-in checkboxes are required to collect consent from the customer indicating they would like to receive additional emails and/or SMS messages from your company. See an example referral widget below:

Friendbuy Custom Attributes | Definition |
Friendbuy Referral Status | Referrers are categorized as Advocate and referees are categorized as Referred Friend |
Friendbuy Customer Name | The name the customer entered when submitting their info through a referral widget |
Friendbuy Referral Link | A personal referral link (PURL) generated for an Advocate. For example, https://fbuy.io/EzcW |
Friendbuy Date of Last Share | The date and time the Advocate last shared with a Friend via any share channel. If the Advocate has not shared yet, the property won't be visible. |
Friendbuy Campaign ID | The Campaign ID associated with the personal referral link generated for an Advocate |
Friendbuy Campaign Name | The Campaign Name associated with the personal referral link generated for an Advocate |
Friendbuy Coupon Code | The most recent Referral coupon code distributed to the customer. Note: only one code will be displayed |
Friendbuy Coupon Value | The currency value of the most recent coupon code distributed to the customer. |
Friendbuy Coupon Status | The status of the most recent coupon code distributed to the customer. Note: status will be 'distributed' or 'redeemed' |
Friendbuy Coupon Currency | Currency code (USD, CAD, etc.) or percent (%) associated with the most recent coupon code distributed to the customer. |
Friendbuy Coupon Campaign ID | The Campaign ID associated with the coupon code generated for a customer. |