Loyalty Program
Custom Action
Reward customers for custom actions via API
Introduction
Create custom earning rules that trigger when you send a specific API call. This is useful for rewarding actions that happen outside of Shopify, like completing a quiz, attending an event, or any custom interaction.
This feature is coming soon. Contact support to be notified when it's available.
Enabling Custom Action Reward
Create the Rule
Go to Subscribfy → Loyalty → Rewards Program tab → Create new rule → Custom Action
Configure Basic Settings
| Setting | Description |
|---|---|
| Name | Display name (e.g., "Complete Quiz Bonus") |
| Action Key | Unique identifier for this action (e.g., "quiz_complete") |
| Reward Amount | Points to award (e.g., 50 points) |
| Reward Message | Message shown when reward is earned |
Configure Advanced Settings (Optional)
| Setting | Description |
|---|---|
| One-time only | Whether customer can earn this reward only once |
| Customer tags | Include or exclude customers by their Shopify tags |
| Tier restriction | Limit which tiers can earn this reward |
Save
Click Save and make sure the rule status is ON.
How to Trigger Custom Actions
Once your rule is created, you can trigger it via API:
POST /api/loyalty/custom-action
{
"customer_email": "customer@example.com",
"action_key": "quiz_complete"
}When the API call is received, Subscribfy:
- Finds the customer by email
- Looks up the rule by action key
- Awards points if all conditions are met
Use Cases
- Quiz completion - Reward customers for completing a product quiz
- App download - Points for downloading your mobile app
- Event attendance - Reward customers who attended an event
- Survey responses - Points for completing customer surveys
- Video watch - Reward for watching product videos
Klaviyo Integration
If you have Klaviyo connected, Subscribfy sends a Subscribfy Custom Action Event when a customer earns points from a custom action.
Event Properties
| Property | Variable Name | Example Value |
|---|---|---|
| Reward Name | event.SubscribfyRewardName | Complete Quiz Bonus |
| Reward Type | event.SubscribfyRewardType | points |
| Reward Amount | event.SubscribfyRewardAmount | 50 |
| Action Key | event.SubscribfyActionKey | quiz_complete |
Troubleshooting
Need help? Contact support at support@subscribfy.com