Skip to main content
Appstle Loyalty integrates natively with Shopify Flow, giving you 8 event triggers and 6 actions. You can automate loyalty workflows entirely within Shopify’s no-code automation builder — no webhooks or API calls required.

Getting started

1

Turn on loyalty triggers

In your Appstle Loyalty admin, go to More → App Integrations and open the Automation Integrations tab. Click Set up on the Shopify Flow card, select Enable Loyalty event triggers, then click Save.
2

Open the Shopify Flow editor

Navigate to the Shopify Flow editor in your Shopify admin.
3

Create a workflow

Click Create workflow, choose an Appstle Loyalty trigger, add conditions if needed, and attach Appstle Loyalty actions.
Triggers stay off until you select Enable Loyalty event triggers. Actions work without it.

Triggers

Triggers fire when loyalty events occur in Appstle and pass customer and loyalty data into your Flow workflow.

When the earned triggers fire

Loyalty Points Earned and Loyalty Credits Earned fire when an earn rule awards a customer points or store credit automatically, such as for an order. They don’t fire for points or store credit added through the Admin API, a Shopify Flow action or a manual adjustment in the Appstle Loyalty admin. Points for reviews, store visits and social media actions don’t fire them either. Every award fires one trigger, by what the earn rule gives: Loyalty Points Earned for points and Loyalty Credits Earned for store credit. Points and Credits are the amount the award gave. A workflow that uses both triggers runs once for each award, from the trigger that matches its reward. The trigger fires as soon as Appstle saves the award, including when it starts as Pending. An award saved as Rejected fires no trigger. An award is pending when the earn rule’s When points arrive is set to After a waiting period or After you approve them, or when the Order points arrive setting waits until the order is paid or fulfilled. The trigger doesn’t fire again when the points are approved. No other trigger reports the approval either, whether the merchant approves the points, the waiting period ends or the order is paid or fulfilled. A workflow can’t act on points moving from Pending to Approved. The trigger carries no transaction ID and no transaction status. Appstle builds Customer Loyalty Details after it saves the award. In Loyalty Points Earned, the points balances include it: an approved award counts in availablePoints and a pending one in pendingPoints. When one order triggers more than one earn rule, every trigger’s balances include all of that order’s awards. availablePoints and pendingPoints count points only, so a store credit award never appears in them. To find out later whether pending points were approved, read the customer’s point transaction history. Find the newest transaction (by createAt) whose earnRuleId and points match the trigger’s Earn Rule ID and amount, then check its status: PENDING, APPROVED or REJECTED. For the customer’s current balances, read their loyalty details, which return pendingPoints and availablePoints.

When the referral triggers fire

Referral Reward Created fires for the customer who referred the friend, and Referred Reward Created for the friend, each when that customer gets their reward. The merchant’s referral program sets when that is: when the friend accepts the invite, creates an account, visits the store or places a qualifying order, so the two triggers can fire at different times. The trigger’s customer is the one who got the reward, and Note describes the reward. A points reward for the friend’s order or new account also fires Loyalty Points Earned.

Trigger properties

All triggers include a customer_reference (Shopify customer reference) and a Note string. Appstle writes Note, and a workflow can’t change it. What it holds depends on the trigger: Note is text written for the customer, and it changes when the merchant edits an earn rule’s message or a reward’s label. Base a workflow’s conditions on the trigger and the properties below, not on Note. The three points and credits triggers (loyalty-points-earned, loyalty-points-redeemed, loyalty-credits-earned) additionally include:
  • Points or Credits — the decimal amount earned or redeemed
  • Earn Rule ID or Redeem Rule ID — the rule that triggered the activity
Every trigger also carries a nested Customer Loyalty Details object: Each item in the rewards array contains:
The Flow schema exposes a subset of fields from the full customer loyalty object. Fields such as storeCreditBalance, vipTierExpiredAt, rewardedForSharingOnFacebook, and rewardedForSharingOnX are present in webhook payloads but are not available in Shopify Flow.

Actions

Actions let your Flow workflows modify loyalty data in Appstle.

Add Points

The points (Decimal) field is deprecated. Use pointsToAdd instead. If you see the old field in an existing action, remove and re-add the action block to get the current version.

Remove Points

Shopify Flow resends an action with the same action run ID when it doesn’t get a response in time. Add Points and Remove Points apply the points once per action run, so a resent action doesn’t add or remove them again.

Add Store Credits

Remove Store Credits

Reward Points for Reviews

Use this action to automatically award points when a review is submitted through a supported platform. Supported review-type values:

Assign VIP Tier

The tier name must exactly match a VIP tier configured in your Appstle Loyalty settings — for example, "Gold" or "Silver". If the customer is already on the specified tier, no changes are made.Appstle tags the customer with the tier name and the tier’s Tag customers in this tier tags. If the customer had another tier, Appstle first removes that tier’s name tag and its Tag customers in this tier tags. For a customer already on the tier, the action doesn’t add tags that are missing.

Pre-built Flow templates

Appstle provides ready-to-use Flow templates for common review platform integrations: Install a template from the Shopify Flow template library and it will be pre-configured with the correct action fields for that platform.

Example workflows

A tag this workflow adds stays on the customer after they leave Gold. To have Appstle add a tag with the tier and remove it when the customer leaves, list it under Tag customers in this tier on the Gold tier instead.

Next steps

Webhooks

Receive an event on your server when a customer joins, earns or redeems points, reaches a VIP tier or gets a referral reward.

Admin API integration guide

Manage points, enrollment, referrals, rewards and store credits from your server.

Klaviyo events

The events Appstle Loyalty sends to Klaviyo, when each is sent and the properties it carries.

API changelog

Dated changes to the Flow triggers and actions, webhooks and the Loyalty APIs, with what to do about each.