Friendbuy x Postscript Integration
Overview
The Friendbuy and Postscript integration allows Shopify merchants to amplify their referral and loyalty programs through SMS. By connecting the two platforms, Friendbuy will sync opted-in subscribers and send referral and loyalty events to Postscript — enabling you to map keywords to Advocate and Friend phone numbers and trigger SMS automations based on real-time referral and loyalty activity.
How It Works
When a customer takes a meaningful action in your Friendbuy referral or loyalty program (such as sharing a referral link, earning points, or receiving a reward), Friendbuy sends that event to Postscript. Those events trigger automated SMS flows you define in Postscript, with Friendbuy subscriber properties available for personalization in every message.
Friendbuy will also create a new subscriber in Postscript when an Advocate or Referred Friend opts into SMS marketing on a referral widget or Friend Incentive widget.
Key capabilities:
- Sync opted-in Advocate and Friend phone numbers to Postscript subscriber lists
- Send referral and loyalty events to Postscript for SMS automation triggers
- Populate subscriber profiles in Postscript with Friendbuy data properties (coupon codes, points balance, tier, and more)
- Map Postscript keywords separately to Advocates and Friends (or use the same keyword for both)
Prerequisites
Before setting up the integration, make sure you have:
- An active Friendbuy account (paid plan required)
- An active Postscript account with keywords configured
- Admin access to both platforms
- Shopify as your e-commerce platform
Setup Instructions
- Navigate to Integrations in the Friendbuy Developer Center
In your Friendbuy account, go to Developer Center in the top navigation, then select the Integrations tab. You will see the full list of available integrations. Locate the Postscript tile and click Add integration.
- Configure the Postscript Integration
After clicking Add integration, the Postscript Integration setup panel will open. Complete the following fields:
API Key (required)
Paste your private API key from your Postscript account into the API Key field, then click Save & validate. Friendbuy will verify the connection. Once validated, the Advocate Keyword and Friend Keyword dropdowns will populate with your available Postscript keywords.
To find your Postscript private API key: log in to Postscript, navigate to Settings > API, and copy your Private API Key.
Postscript SMS — Keyword Mapping
Select which Postscript keywords you want Friendbuy to use when adding phone numbers to your subscriber lists after customers opt in.
Advocate Keyword — the Postscript keyword applied to customers who share referral links (advocates)
Friend Keyword — the Postscript keyword applied to referred friends who opt in
If you want to use the same keyword for both, check the Send Phone Numbers to the same Advocate and Friend Keywords checkbox and select a single keyword.
Sync Settings
Subscriber sync — Push opted-in advocates and friends to your Postscript subscriber lists automatically
Event sync — Send referral and loyalty events from Friendbuy to Postscript to trigger SMS automations
Both are enabled by default. We recommend keeping both on for the full integration experience.
- Install the Integration
Once your API key is validated, keywords are mapped, and sync settings are configured, click Install integration. The integration status will update from Not connected to Connected, and the Last sync field will populate after the first sync completes.
What You'll See in Postscript
Once a subscriber is synced from Friendbuy, they will appear in your Postscript Conversations view with a full set of Friendbuy properties attached to their profile. These properties are available as personalization variables in any SMS flow or campaign you build in Postscript.
The following Friendbuy properties are passed to each subscriber profile in Postscript:
Property Name in Postscript | Description |
Friendbuy Campaign ID | Unique ID of the Friendbuy campaign associated with this subscriber |
Friendbuy Campaign Name | Display name of the Friendbuy campaign |
Friendbuy Coupon Code | Coupon code distributed to this subscriber |
Friendbuy Coupon Value | Value of the distributed coupon |
Friendbuy Coupon Currency | Currency type for the coupon value (e.g. Points, USD) |
Friendbuy Coupon Currency Symbol | Symbol for the coupon currency |
Friendbuy Coupon Status | Status of the coupon (e.g. distributed, redeemed) |
Friendbuy Coupon Campaign ID | Unique ID of the coupon campaign |
Friendbuy Customer Name | Name of the Friendbuy customer |
Friendbuy Consent Status | Whether the customer has consented (yes/no) |
Friendbuy Consent Timestamp | Date and time consent was captured |
Friendbuy Points Balance | Customer's current loyalty points balance |
Friendbuy Member Tier Name | Customer's current loyalty tier name |
Friendbuy Date of Last Share | Date and time of the customer's most recent referral share |
Friendbuy Loyalty Opt-In Date | Date and time the customer opted into the loyalty program |
Events Sent to Postscript
When Event sync is enabled, Friendbuy sends the following events to Postscript to trigger SMS automations:
Friendbuy Event | Description |
Referral Shared | Customer shares their referral link via any channel |
Referral Converted | A referred friend completes a qualifying purchase |
Referral Reward Issued | Advocate receives a reward for a successful referral |
Points Earned | Customer earns loyalty points from a purchase or action |
Points Redeemed | Customer redeems loyalty points for a reward |
Tier Upgraded | Customer advances to the next loyalty tier |
Reward Issued | A loyalty reward is issued to a customer |
Frequently Asked Questions
Does this integration require a developer?
No. The integration is configured entirely within the Friendbuy Developer Center using your Postscript API key. No custom code is required.
Which Friendbuy plan is required?
The Postscript integration is available on Friendbuy paid plans. Contact your Customer Success Manager to confirm availability for your tier.
Can I use this for both referral and loyalty programs?
Yes. Subscriber sync and event sync apply to activity across both Friendbuy's referral and loyalty products.
Is data synced in real time?
Yes. Friendbuy sends events and property updates to Postscript in real time as customers take actions in your program.
What if a customer is not yet a Postscript subscriber?
If a customer's phone number is not opted in as a Postscript subscriber, the event will be received but an SMS flow will not trigger. Make sure your opt-in flows are capturing phone numbers before relying on SMS automations.
What is the difference between Advocate Keyword and Friend Keyword?
Postscript uses keywords to identify and segment subscribers. Friendbuy maps these keywords separately so Advocates and Friends can be targeted with different SMS automations.
Is bidirectional sync supported?
Currently, the integration sends data from Friendbuy to Postscript.
Troubleshooting
Issue | Likely Cause | Fix |
Keywords not loading in dropdowns | API key not yet validated | Click Save & validate before attempting to select keywords |
Events not appearing in Postscript | Event sync is toggled off | Check Sync Settings and enable Event sync |
Subscribers not syncing | Subscriber sync is toggled off | Check Sync Settings and enable Subscriber sync |
Friendbuy properties missing from subscriber profile | Sync has not yet completed | Wait a few minutes and refresh the subscriber profile in Postscript |
Customer not receiving SMS | Not an opted-in Postscript subscriber | Verify subscriber and opt-in status in Postscript |
Connection error on save | Incorrect or expired API key | Regenerate your API key in Postscript and re-enter it in Friendbuy |
Integration showing "Not connected" after install | Install step was not completed | Ensure you clicked Install integration after configuring all fields |
Support
For Friendbuy-related questions, contact support@friendbuy.com or visit our Help Center.
For Postscript-related questions, visit the Postscript Help Center.
