Skip to main content
Shopify Flow is Shopify’s automation app: it lets you build “when this happens, do that” rules without writing code. Livy connects to Flow and adds two pieces: a step to adjust points (Adjust Livy points) and a trigger that fires when Livy adds points (Livy points awarded). With them you can reward the customers you tag as VIP, subtract points when an order is refunded, or notify your team on Slack every time someone earns points.

Before you start

  • Your Livy plan must be Starter or higher. The Free plan does not include this integration.
  • You need the Shopify Flow app installed. It is free and published by Shopify.
In Livy you can see the status of this integration under Configurations > Shopify Flow.

The step: Adjust Livy points

Add it as an action in any workflow. It adds or subtracts points for a customer.

The sign is what decides

A positive number adds. A negative one subtracts. 0 is rejected, because a zero-point adjustment is not an adjustment.
If the customer does not have enough balance, we subtract as much as there is and the workflow still succeeds. If you ask to subtract 500 and the customer has 100, those 100 are subtracted and the balance lands at zero: they are never left owing points and Flow does not mark the step as failed.This is on purpose. The normal case for a subtraction is penalizing a refund, and by then the customer has often already spent the points. Failing would fail exactly when you most want to collect.

The trigger: Livy points awarded

Use it to start a workflow. It fires when Livy adds points.

When it does NOT fire

  • When you adjust points by hand from the Livy admin.
  • When you import your customer or order history.
  • When the points come from the Flow step itself.
That last one matters most: without it, a workflow that awards points would trigger itself in a loop.

Examples

Reward a VIP customer

1

Trigger: Customer tags added (from Shopify)

2

Condition: the tag is VIP

3

Action: Adjust Livy points, with Points set to 500 and Reason 'VIP customer'

Subtract points on a refund

1

Trigger: Order refunded (from Shopify)

2

Action: Adjust Livy points, with Points set to -200 and Reason 'Order refunded'

This is the case that justifies the step being an adjustment and not just an award.

Notify the team when someone earns points from a rule

1

Trigger: Livy points awarded

2

Condition: Source equals earn_rule

3

Action: Send Slack message, using Points awarded and Rule in the text

If something fails

Flow shows you the reason in the workflow run history. These are the messages Livy can return.
The messages are copied exactly as Flow shows them, so you can search this page for the one you see.

The step retries on its own

If the problem is temporary (Livy does not answer for a moment), Flow retries the step for hours without you doing anything. The messages in the table above are the ones that do not fix themselves: there Flow stops and shows them to you.

Re-running a workflow does not duplicate points

Every run has its own identifier. If Flow retries the same one, Livy recognizes it and does not adjust again.

We build Livy together.

Don’t hesitate to reach out if you need help or have a suggestion. You can write to us at [email protected]. We’re here to help.