Skip to main content

How to Integrate CWILL Loyalty with Shopify Flow

Use CWILL Loyalty triggers and actions in Shopify Flow to react to loyalty moments, give points from any app, and manage VIP tiers, with examples and troubleshooting.

Introduction

Connect CWILL Loyalty to Shopify Flow to react to loyalty moments, and to give points or change VIP tiers from anything that happens in your store or other apps.


Walkthrough Video


How CWILL Loyalty Works with Shopify Flow

A workflow has three parts. See Shopify's guide to Flow for more.

  • Trigger: the event that starts the workflow.

  • Condition (optional): rules that decide whether it continues.

  • Action: what happens as a result.

CWILL Loyalty provides both:

  • Triggers: start a workflow when something happens in your loyalty program.

  • Actions: give points or change a VIP tier from any trigger.

Build a workflow

  1. Open Shopify Flow and click Create workflow.

  2. Click Select a trigger and pick one from CWILL Loyalty or any other app.

  3. Click Add a condition or action and set up the next step.

  4. Click Turn on workflow.


CWILL Loyalty Triggers

Every CWILL Loyalty trigger includes customer (Customer), so you can check the customer's tags, order count or total spent in a condition, and use any customer action, like adding a tag or sending a Shopify Email. Insert trigger data anywhere with Add variable, for example {{pointsAdded}}.

Each trigger below lists its other properties.

Dates are text in your store's time zone. You can show them in a message but can't compare them in a condition.

  • Reward redemption and expiry dates include the time, like 2026-12-13T15:42:00+08:00. A reward expires at that moment, not at the end of the day.

  • Points expiry and birthday dates are dates only, like 2026-10-13.

To format a date, add a filter, like {{rewardExpiryDate | date: "%b %d, %H:%M"}} for Dec 13, 15:42.

Points

Points earned: a customer earns points.

Property

Type

Description

pointsAdded

Number

Points earned.

earnAction

Text

How they were earned, like Place an order, Sign up reward, Leave a review or Flow reward.

activityTitle

Text

Activity name shown to customers.

Points expiring - Warning / Points expiring - Last chance: the first / last reminder before points expire.

Property

Type

Description

expiringPoints

Number

Points about to expire.

pointsExpiryDate

Text (date)

When the points expire, like 2026-10-13.

expiringDaysBefore

Number

Days left.

Rewards

Reward redeemed: a customer redeems points for a reward.

Property

Type

Description

rewardCode

Text

Discount code.

rewardName

Text

Reward name.

rewardTerms

Text

Reward details and conditions.

rewardRedeemedDate

Text (date and time)

When the reward was redeemed, like 2026-10-13T15:42:00+08:00.

pointsSpent

Number

Points spent.

rewardExpiryDate

Text (date and time)

When the reward expires, like 2026-12-13T15:42:00+08:00.

Reward expiring - Warning / Reward expiring - Last chance: the first / last reminder before a reward expires.

Property

Type

Description

rewardCode

Text

Discount code.

rewardName

Text

Reward name.

rewardExpiryDate

Text (date and time)

When the reward expires, like 2026-12-13T15:42:00+08:00.

expiringDaysBefore

Number

Days left.

Referrals

In both referral triggers, customer is the person who shared the referral link.

Referral share: a referred friend claims their reward. It doesn't wait for the referral to be completed.

Property

Type

Description

customerName

Text

Referrer's name.

customerEmail

Text

Referrer's email.

friendRewardName

Text

Friend's reward name.

friendRewardCode

Text

Friend's discount code.

Referral completed: a referral is completed and the referrer gets a reward.

Property

Type

Description

friendEmail

Text

Friend's email.

customerRewardName

Text

Referrer's reward name.

customerRewardCode

Text

Referrer's discount code.

customerRewardPoints

Number

Referrer's points.

referralCompletionCount

Number

Referrer's total completed referrals, including this one.

Birthdays

Birthday reward available: a customer can claim their birthday reward.

Property

Type

Description

birthdayPoints

Number

Birthday points to claim.

birthdayDate

Text (date)

Birthday, like 1970-10-13. The year is 1970 if the customer didn't set one.

Customer's birthday: a member's birthday, whether or not they can claim a reward. Sends only customer.

VIP tiers

Customer moved up a tier / Customer moved down a tier: a customer moves to a higher / lower VIP tier.

Property

Type

Description

vipName

Text

Tier after the change.

previousVipTier

Text

Tier before the change. Empty if there was none.

📝 Good to know

  • Points earned runs a lot. Every run counts toward your Flow usage. Add a condition, like pointsAdded is greater than 100 or earnAction is Place an order.

  • Reminders run once a day. Expiry reminders and Birthday reward available are checked daily in your store's time zone. Each customer gets each reminder once. Changing the reminder days doesn't resend past reminders.

  • Set expiry reminder days in Integrations > Event settings > Expiry reminder timing. The same days apply to Klaviyo, Omnisend and webhooks.

  • No past events. Triggers only run for events after the workflow is turned on.


CWILL Loyalty Actions

Actions change a customer's points or VIP tier, after any trigger.

Action

What it does

Complete an earning activity

Completes a Ways to Earn activity. Points and limits follow the activity.

Adjust points by variable

Adds or deducts a number calculated in Flow, like 2× the order total.

Adjust points by fixed amount

Gives the same points every run.

Assign an exclusive VIP tier

Moves a customer into a tier and keeps them there.

Remove an exclusive VIP tier

Returns the customer to the tier they've earned.

Run limit

If CWILL Loyalty actions run 30 times in 10 minutes, the actions that give points or tiers pause. This stops a looping workflow from giving away points. See Setups to Avoid.

Paused:

  • Adjust points by variable, when it adds points

  • Adjust points by fixed amount

  • Complete an earning activity

  • Assign an exclusive VIP tier

Still run:

  • Adjust points by variable, when it deducts points

  • Remove an exclusive VIP tier

Only Flow actions count. Points from orders, reviews, and other ways to earn don't count toward the limit.

Choose the customer

Most actions have two customer fields, Customer and Customer email. Adjust points by fixed amount only has Customer, so use it with a trigger that includes a customer.

  • Trigger includes a customer (like Order created or any CWILL Loyalty trigger): Flow fills in Customer. Leave Customer email empty.

  • Trigger only has an email (like many review or survey apps): the panel shows No customer found. Under Customer email, click Add variable and pick the email variable, like {{reviewerEmail}}.

The customer fields aren't repeated in the tables below.

1. Complete an earning activity

Completes an activity under the same rules as any other customer: it must be turned on and active, the customer must be eligible, and limits apply. Points history shows the activity name.

Fields

Field

Required

Description

Activity ID

Yes

See Find an Activity ID or Tier ID.

Returns

Property

Type

Description

status

Text

SUCCESS, SKIPPED or FAILED.

activityId

Text

Activity that ran.

activityType

Text

Activity type.

pointsAwarded

Number

Points given. 0 if none.

rewardResult

Text

Reward given. Empty if none.

balance

Number

Balance after the run.

transactionId

Text

Points transaction. Empty if no points.

skipReason

Text

Why it was skipped.

failureReason

Text

Why it failed.

⚠️ Keep in mind

  • Place an order isn't supported.

2. Adjust points by variable

Adds or deducts a number calculated in Flow.

Fields

Field

Required

Description

Points to adjust

Yes

A number, or an expression built with Add variable. For example, 2 points per $1 spent:

{{order.currentTotalPriceSet.shopMoney.amount | times: 2}}

Negative numbers deduct points. Decimals round to the nearest whole number (0.5 rounds up). Add | floor to always round down.

Reason

Yes

Shown in the customer's points history as Shopify Flow dynamic points, like Double points weekend.

Returns

Property

Type

Description

status

Text

SUCCESS or FAILED.

pointsAwarded

Number

Points changed. Negative if deducted.

balanceAfter

Number

Balance after the run.

transactionId

Text

Points transaction.

reason

Text

The reason you entered.

failureReason

Text

Why it failed.

⚠️ Keep in mind

  • No earning limits. It runs every time the workflow runs, up to the Run limit above. Use your trigger and conditions to control when.

  • Balances can go below zero if you deduct more than the customer has.

  • A result of 0 succeeds without changing points.

  • Adding points sends the points earned email and updates the VIP tier.

3. Adjust points by fixed amount

Gives the same points every run. This is the former Add Points action; existing workflows keep running unchanged.

Fields

Field

Required

Description

How many points to earn

Yes

Points to give.

Instructions for earning points

Yes

Shown in the customer's points history.

⚠️ Keep in mind

  • No earning limits. It runs every time the workflow runs, up to the Run limit above. Use your trigger and conditions to control when.

4. Assign an exclusive VIP tier

Moves the customer into a tier. They stay there and no longer move up or down automatically. If they're already in that tier, they're kept there.

Fields

Field

Required

Description

Tier ID

Yes

Any tier. See Find an Activity ID or Tier ID.

Issue entry reward

No

Checkbox, off by default. Gives the tier's entry rewards. Only applies when the customer moves up, and follows your tier skipping and re-entry settings.

Returns

Property

Type

Description

status

Text

SUCCESS or FAILED.

previousTier

Text

Tier before the change.

newTier

Text

Tier after the change.

entryRewardIssued

Text

Entry reward given. Empty if none.

changedAt

Date and time

When the tier changed.

failureReason

Text

Why it failed.

5. Remove an exclusive VIP tier

Removes the assigned tier and returns the customer to the tier they've earned. Skipped if they have no assigned tier. No fields besides the customer.

Returns

Property

Type

Description

status

Text

SUCCESS, SKIPPED or FAILED.

removedTier

Text

Tier removed.

restoredTier

Text

Tier after removal.

changedAt

Date and time

When the tier changed.

skipReason

Text

Why it was skipped.

failureReason

Text

Why it failed.

Find an Activity ID or Tier ID

  1. In CWILL Loyalty, open the activity under Program > Points > Earn points, or the tier under Program > VIP > VIP tier.

  2. In Summary on the right, click the copy icon next to the ID.

  3. Paste it into the action in Flow.

Place an order activities have no ID because they can't be used in Flow.

Use what an action returns

Later steps can use an action's Returns with Add variable. For example, if status is FAILED, send a Slack message with failureReason.


Core Scenarios and Examples

Scenario 1: React to loyalty moments

CWILL Loyalty trigger + any action. Tag customers, add them to a segment, notify your team, or send data to another app.

Example: tag customers whose points are about to expire

  1. Trigger: CWILL Loyalty > Points expiring - Warning

  2. Condition: Expiring points is greater than 500

  3. Action: Shopify > Add customer tags, tag points-expiring

Then target the points-expiring segment with an ad or a Shopify Email campaign.

More ideas

  • Notify your team about top customers: Customer moved up a tier → condition: new tier is your top tier → Send internal email.

  • Send referrals to your CRM: Referral completed → Send HTTP request.

  • Follow up on unused rewards: Reward expiring - Last chance → Add customer tags.

Scenario 2: Reward actions CWILL Loyalty can't see

Any trigger + Complete an earning activity. Reward a review in another app, a survey, a quiz, or joining a segment. Create the activity in CWILL Loyalty first, then copy its ID into Flow.

Example: give points for 4+ star Loox reviews

  1. In CWILL Loyalty, go to Program > Points > Earn points, open Leave a review, and select Shopify Flow as the review app.

  2. Copy the Activity ID from Summary.

  3. Build the workflow:

    • Trigger: Loox - Product Reviews App > New review

    • Condition (optional): Rating is 4 or higher

    • Action: CWILL Loyalty > Complete an earning activity. Paste the Activity ID, and set Customer email to the reviewer's email.

  4. Click Turn on workflow.

Points and limits follow your Leave a review settings. No photo bonus for reviews from Flow.

Example: reward a product quiz with a Custom Action

  1. In CWILL Loyalty, go to Program > Points > Earn points, click Add ways to earn, and choose Custom action. Set the name, points, completion limit and icon, like Complete a product quiz, 150 points, once per customer. Leave the action button off if Flow is the only way to complete it.

  2. Save, then copy the Activity ID from Summary.

  3. Build the workflow:

    • Trigger: your quiz app's Quiz completed, or any other event

    • Condition (optional): keep only the events you want to reward

    • Action: CWILL Loyalty > Complete an earning activity. Paste the Activity ID. Set Customer email if the trigger has no customer.

Customers see the activity in your loyalty program with its own name and icon, and in points history. Flow only decides when it's completed.

More ideas

  • Reward a survey: survey submitted → Complete an earning activity with a custom activity. Set Customer email to the survey's email.

  • Reward joining a segment once: Customer joined segment → Complete an earning activity limited to once per customer. Later joins are skipped.

  • Reward subscription renewals: renewal trigger → Complete an earning activity with your renewal activity.

Scenario 3: Give points calculated in Flow

Any trigger + Adjust points by variable. When points depend on trigger data, like the order total, items or tags. For the same points every time, use Adjust points by fixed amount.

Example: double points for VIP-tagged customers

  1. Trigger: Shopify > Order paid

  2. Condition: Customer tags include VIP

  3. Action: CWILL Loyalty > Adjust points by variable

    • Points to adjust: {{order.currentTotalPriceSet.shopMoney.amount | times: 2}}

    • Reason: VIP double points

More ideas

  • Extra points for a collection: Order paid → condition: order includes the collection → Adjust points by variable, item count × 50.

  • Take points back on refund: refund trigger → Adjust points by variable with a negative number.

  • Points back on big redemptions: Reward redeemed → condition: Points spent is at least 1000 → Adjust points by fixed amount, 50.

Scenario 4: Manage VIP tiers from Flow

Any trigger + Assign / Remove an exclusive VIP tier. Put customers in a tier based on something CWILL Loyalty doesn't track, like a tag, segment or partnership.

Example: put partner-tagged customers in Gold

Workflow 1, assign the tier:

  1. Trigger: Shopify > Customer tags added

  2. Condition: Tags include partner

  3. Action: CWILL Loyalty > Assign an exclusive VIP tier. Tier ID: your Gold tier ID, like 5009. Leave Issue entry reward off.

Workflow 2, remove it:

  1. Trigger: Shopify > Customer tags removed

  2. Condition: Tags include partner

  3. Action: CWILL Loyalty > Remove an exclusive VIP tier

Scenario 5: Reward referral milestones

Referral completed + one branch per milestone. Use referralCompletionCount so each bonus is given once, on the referral that reaches it.

Example: bonuses for the 2nd, 3rd and 4th referral

  1. Trigger: CWILL Loyalty > Referral completed

  2. Condition branches, each followed by CWILL Loyalty > Adjust points by fixed amount:

    • Referral completion count is equal to 4 → 500 points, 4th successful referral bonus

    • Otherwise, equal to 3 → 300 points, 3rd successful referral bonus

    • Otherwise, equal to 2 → 200 points, 2nd successful referral bonus

Use is equal to, not greater than or equal to, or the 2nd-referral bonus repeats on every later referral. Turn on Referral completed in Integrations > Event settings first.


Setups to Avoid

⚠️ Points earned → Adjust points by variable or fixed amount

The new points start Points earned again, in an endless loop. Add the condition: Earn action is not Flow reward.

⚠️ Complete an earning activity with Place an order, Sign up, or CWILL Product Reviews / Judge.me review activities

CWILL Loyalty already gives these points, so customers get them twice.

⚠️ Customer moved up a tier → Assign an exclusive VIP tier to a higher tier

Each change starts the trigger again and can push customers to the top tier.


Troubleshooting

Errors when you save a workflow

  • "Add the customer's email, or use a trigger that includes a customer."

    Set Customer email, or use a trigger with a customer.

  • "This isn't a customer. Pick a customer variable, like {{customer.id}}."

    Pick a customer variable for Customer.

  • "We can't find this activity…" / "We can't find this tier…"

    Copy the ID again from the activity's or tier's Summary.

  • "Place an order activities can't be used here."

    Pick another activity, or use Adjust points by variable.

A run didn't give points or change a tier

Check Recent runs in the workflow.

  • Customer not found (failed)

    The email is empty, matches no customer or several, or the customer isn't a member yet. Adjust points by variable also works for non-members.

  • No change made. Check the settings in CWILL Loyalty. (skipped)

    For example, the customer isn't eligible or hit the limit, the activity is off or inactive, or there's no assigned tier to remove.

  • Couldn't complete this step. Check the settings in CWILL Loyalty. (failed)

    For example, the activity calculates points from order data, Points to adjust isn't a number, or the activity or tier was deleted or turned off.

Still stuck? Contact us through live chat with the workflow name and run time.


Related Articles

Did this answer your question?