Friendbuy is a referral and loyalty marketing platform that helps brands acquire new customers through referral programs and retain them through loyalty programs.
With the Friendbuy integration, referral rewards, loyalty events, and customer profile data sync automatically to Omnisend, allowing you to trigger targeted email and SMS automations at every stage of the referral and loyalty journey.
Benefits
Real-time event triggers: Instantly respond to referral rewards, loyalty milestones, and receipt processing events.
Advanced segmentation: Tailor content for advocates, referred friends, and loyalty members based on their referral status and tier.
Automated customer communication: Notify contacts of earned rewards, tier upgrades, and receipt approvals through Automation Workflows.
Contact enrichment: Referral status, coupon codes, loyalty tier, and personal referral links (PURLs) sync automatically to contact profiles.
Setup Process
Step 1. In Omnisend, go to Apps → search for the Friendbuy app and click Connect Now.
Step 2. Enter your Friendbuy API Key and API Secret (found in Friendbuy → Developer Center → API Keys) and proceed to the next step.
Step 3. Under each selected automation, you'll see a webhook URL. This URL is required for Omnisend to receive events from Friendbuy.
Copy each webhook URL and paste it into the corresponding webhook field in Friendbuy → Developer Center → Webhooks & Callbacks, then click Offline - Click to enable to activate it.
Register webhook URLs for the automations you want to use:
Automation | Paste URL into Friendbuy |
Referral - Advocate Reward | Advocate Reward Webhook |
Referral - Friend Incentive | Friend Incentive Webhook |
Referral - Email Capture | Email Capture Webhook |
Loyalty - Loyalty Reward | Loyalty Reward Webhook |
Loyalty - Receipt Processing | Receipt Processing Webhook |
Loyalty - Customer Update | Customer Update Webhook |
Step 4. Confirm the setup in Omnisend.
That's it! All relevant Friendbuy events will now be triggered as custom events in Omnisend.
What Data is Passed
Contact Fields in Contact Profiles
The following fields will be added to the contact profile in Omnisend:
Email address
First Name
Tag:
Friendbuy(added to all contacts)
Contact Custom Properties
Custom Property | Description |
|
|
| Name entered in the referral widget |
| Campaign ID of the most recent event |
| Campaign name of the most recent event |
| Most recent coupon code distributed |
| Value of the most recent coupon |
| Currency code (USD, %, etc.) |
|
|
| Personal referral link (PURL) - advocates only |
| Email of the referring advocate - friends only |
| Friendbuy customer ID |
| Loyalty opt-in status ( |
| Date customer enrolled in loyalty program |
| Current loyalty tier name (e.g., Gold, Platinum) |
| Date the tier was last updated |
💬 Learn more: Custom Properties.
Supported Custom Events
Custom Event Name | Description |
| Triggered when an advocate earns a reward after a successful referral |
| Triggered when a referred friend earns an incentive after converting |
| Triggered when a referred friend submits their email via a referral widget |
| Triggered when a loyalty member earns a reward from a purchase |
| Triggered when a loyalty member earns a reward for joining the program |
| Triggered when a loyalty member earns a reward for referring a friend |
| Triggered when a loyalty member earns a reward for completing a sign-up event |
| Triggered when a loyalty member earns a reward from a custom event |
| Triggered when a loyalty member's tier changes |
| Triggered when a loyalty receipt is approved or rejected |
Build Automation Workflows with Friendbuy Events
Here are some automations you can build once the data is flowing:
Advocate reward email: When
Friendbuy - Advocate Reward Earnedfires, send the advocate their coupon code and include their personal referral link ([[contact.Friendbuy_Referral_Link]]) to encourage more sharing.Friend incentive email: When
Friendbuy - Friend Incentive Earnedfires, welcome the referred friend and share their incentive code to complete their first purchase.Email capture nurture: When
Friendbuy - Email Capturefires, follow up with the referred friend before they convert.Loyalty reward notification: When any
Friendbuy - Loyalty Reward *event fires, notify the member of their earned reward, and include their coupon code.Tier upgrade congratulations: When
Friendbuy - Member Tier Changedfires, celebrate the customer's new tier with an exclusive offer.Receipt approved/rejected: When
Friendbuy - Receipt Processedfires, confirm receipt approval, or explain a rejection based on the[[event.Friendbuy_Receipt_Status]]value.
Use Event Properties for Personalization
Inside automation emails, use event properties to personalize content:
Variable | Description |
| The coupon code earned |
| The value of the coupon |
| The campaign name |
| Points earned in this event |
| New loyalty tier name |
|
|
| Customer's personal referral link |
💬 Learn more: Use Personalization in Omnisend.
FAQ
Which Friendbuy plan do I need?
You need a Friendbuy account with access to webhooks in the Developer Center. Contact Friendbuy support to confirm webhook availability for your plan.
Do I need to enable all webhooks?
No - enable only the webhooks relevant to your setup. For referral programs only, enable Advocate Reward, Friend Incentive, and Email Capture. For loyalty programs, also enable Loyalty Reward, Receipt Processing, and Customer Update.
What subscription status will new contacts have?
New contacts created through this integration are set to nonSubscribed by default. They will not receive marketing emails until they opt in through Omnisend's subscription forms.
Does historical data sync?
No - only real-time events from the moment the integration is activated.
Can I use Friendbuy events in Email Campaigns?
Friendbuy events are designed for Automation Workflows. To send one-time campaigns, create a segment based on Friendbuy contact properties (e.g. Friendbuy - Last Referral Status = ADVOCATE) and send a campaign to that segment.
If you couldn't find the answer to your question, reach out to our support team through the in-app chat or at [email protected] - our team is available 24/7.

