Flow Integration
Overview
KNISTR Loyalty Rewards & GDPR provides four triggers and one action for the native Shopify Flow app, so loyalty events can be used inside custom automations and points can be awarded from any Flow workflow.
Requirements
The Shopify Flow app must be installed on the store (available by default on most plans). No separate connection or authorization step is needed — the triggers and action become available automatically once the KNISTR Loyalty app is installed.
Triggers
| Trigger | Fires when |
|---|---|
| Loyalty member joined | A customer joins the loyalty program |
| Loyalty points earned | Points are credited to a customer |
| Loyalty points redeemed | A customer redeems points for a reward |
| Loyalty reward used | A redeemed reward is applied at checkout |
Payload Fields
Loyalty member joined
| Field | Example | Description |
|---|---|---|
| customer.id | gid://shopify/Customer/25368328601940 | Shopify customer GID |
| firstName | andre | Customer's first name |
| lastName | "" | Customer's last name (empty if not set) |
| memberId | 9dce3300-0ba1-470a-af26-a5e8bd3a1846 | Internal KNISTR loyalty member ID |
| shop.id / shop.myshopifyDomain | - | Shop reference |
The other three triggers follow the same base structure; point- and reward-specific triggers additionally carry the relevant point or discount code values.
Action: Award loyalty points
| Field | Required | Description |
|---|---|---|
| customer_id | Yes | Shopify customer GID |
| points | Yes | Number of points to award |
| reason | Yes | Text shown in the customer's activity log |
This action can be attached to any Flow trigger, not only the four loyalty triggers above — for example, a review app's "review submitted" trigger.
Creating a Workflow
- In the Shopify admin, go to Flow.
- Click Create workflow or start from a template.
- Select a trigger, e.g. "Loyalty member joined".
- Add Award loyalty points as the action.
- Map the customer field, set the point amount and reason text.
- Save and activate the workflow.
Example Workflow (active in this store)
Trigger: Loyalty member joined
Action: Award loyalty points - 100 points, reason: "100 points for become loyalty members"
Grants new members 100 welcome points automatically on sign-up.
Using the Action with Other Shopify Triggers
The "Award loyalty points" action is not limited to KNISTR's own four triggers. It can be connected to any trigger available in Shopify Flow — including native Shopify triggers and triggers from other installed apps. This makes it possible to reward loyalty points for actions that have nothing to do with the loyalty app itself.
Two real examples from this store:
Newsletter signup (native Shopify trigger)
- Trigger: "Customer joined segment" (segment: Email subscribers)
- Action: Award loyalty points — 55 points, reason: "Newsletter Anmeldung"
Product review (third-party app trigger)
- Trigger: "New review received" (from the Judge.me Reviews app)
- Action: Award loyalty points — 200 points, reason: "Produktreview hinterlassen"
Any app that exposes its own Shopify Flow trigger (review apps, subscription apps, wishlist apps, etc.) can be combined with the "Award loyalty points" action in the same way — simply select that app's trigger when creating a new workflow, then add "Award loyalty points" as the next step.
If you want to reward only under certain conditions (e.g. only for 4–5 star reviews, or only for a specific segment), add a Condition step between the trigger and the action — see "Common Pitfall" below.
Troubleshooting
- Points aren't being awarded: confirm the workflow's status in Flow is "Active", not "Inactive".
- Trigger never fires: re-check the trigger selection — each of the four triggers only fires for its specific event type (e.g. "Loyalty points redeemed" will not fire on a purchase, only on a redemption).
- Workflow debugging: Workflow runs are kept for 14 days and can be inspected under Recent runs for exact input/output data of each step — useful for debugging field mappings.