Custom Action

Introduction

Create custom earning rules for actions not covered by built-in rules. Use the API to trigger rewards for any customer action in your store or external systems.

Enabling Custom Action

Step 1: Create the Rule

Go to Subscribfy > Loyalty > Rewards Program tab > Create new rule > Custom Action

Step 2: Configure Basic Settings

Name	Display name (e.g., "Complete Quiz")
Action ID	Unique identifier for this action (used in API calls)
Reward Amount	Points to award when action is completed

Step 3: Configure Advanced Settings (Optional)

Customer tags	Include or exclude customers by their Shopify tags
One-time only	Allow reward only once per customer
Tier restriction	Limit which tiers can earn this reward

Step 4: Save

Click Save and make sure the rule status is ON.

Triggering via API

Call the Subscribfy API to trigger the custom action reward:

POST /api/loyalty/custom-action
{
  "customer_id": "gid://shopify/Customer/123456",
  "action_id": "your_action_id"
}

Use Cases

Quiz completion - Reward customers for completing a product quiz
Profile completion - Points for filling out profile details
App usage - Reward mobile app downloads or usage
External actions - Integrate with external systems

Klaviyo Integration

If you have Klaviyo connected, Subscribfy sends a Subscribfy Custom Action Event when a customer earns points.

Event Properties

Property	Variable Name	Example Value
Reward Name	event.SubscribfyRewardName	Complete Quiz
Reward Type	event.SubscribfyRewardType	points
Reward Amount	event.SubscribfyRewardAmount	100