# Shopify Flow x Smartrr Integration

Last updated: May 14, 2025

{% hint style="info" %}
Shopify Flow is an app built by Shopify that empowers you to build custom automations that help you run your business more efficiently. **Flow is only available to customers on Shopify's Advanced or Shopify Plus plan.** [<mark style="color:blue;">Learn more about Shopify Flow here.</mark>](https://apps.shopify.com/flow)
{% endhint %}

## Integration Setup

If you are a shop on Shopify's Advanced or Plus plan, make sure you have downloaded [<mark style="color:blue;">Shopify Flow app from Shopify's App Store</mark>](https://apps.shopify.com/flow).&#x20;

Next, navigate to **Integrations** in your Smartrr admin under CONFIGURATION. Find the block for Shopify Flow and press **Connect**. Your connection will automatically be enabled.&#x20;

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2F9qrGWweZWOrkTpmLVR6e%2Fconnect-shopify-flow.png?alt=media&#x26;token=7588f933-f021-4377-9655-f22cc48a3b22" alt=""><figcaption></figcaption></figure>

## Integration Triggers & Actions

The following are available as triggers/actions from Smartrr from within Shopify Flow:&#x20;

| Name                                        | Type    | Description                                                                                   |
| ------------------------------------------- | ------- | --------------------------------------------------------------------------------------------- |
| **Subscription upcoming order**             | Trigger | A customer has an upcoming subscription order in {X} days                                     |
| **Subscription transaction attempt failed** | Trigger | A customer's order has failed during your shop's Billing Time                                 |
| **Subscription transaction successful**     | Trigger | A customer's order has successfully been run during your shop's Billing Time                  |
| **Subscription unskipped**                  | Trigger | A customer or admin has unskipped an upcoming order                                           |
| **Subscription skipped**                    | Trigger | A customer or admin has skipped an upcoming order                                             |
| **Subscription next order date change**     | Trigger | A customer or admin has changed the next order date for an upcoming order                     |
| **Subscription send now**                   | Trigger | A customer or admin has hit Send Now on their next subscription order in their account portal |
| **Subscription gifted**                     | Trigger | A customer has gifted an upcoming order                                                       |
| **Subscription created**                    | Trigger | A customer has purchased a brand new subscription from your shop                              |
| **Subscription canceled**                   | Trigger | A customer or admin has permanently canceled a customer's recurring subscription              |
| **Subscription activated (unpaused)**       | Trigger | A customer or admin has re-activated a paused subscription                                    |
| **Subscription paused**                     | Trigger | A customer or admin has temporarily paused a customer's recurring subscription                |
| **Skip next order**                         | Action  | Skip the next subscription order\*                                                            |
| **Pause Subscription**                      | Action  | Pauses the subscription automatically                                                         |

**\*Note**—if using "Skip next order" as an action, you'll need to add the variable for the subscription ID:&#x20;

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2Fs00CgQYCbVkEVbjqb4FO%2Fshopify-flows-demo.gif?alt=media&#x26;token=666f01b6-7288-466a-b7de-05ce73e1714c" alt=""><figcaption><p>How to add the subscriptionShopifyID variable when using "Skip next order" action.</p></figcaption></figure>

## Setting up a Flow

To set up a flow, open Shopify Flow from within Apps in your Shopify admin. Click **Create workflow**.

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FlfbDpNToC0QnvlsmGrq0%2Fcreate-workflow.png?alt=media&#x26;token=d8d525a6-8093-4478-8db5-e971f14abc67" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FtJDN2DagaHzZHJh1NOoA%2Fstart-building.png?alt=media&#x26;token=824d9d13-2ff9-43ae-b098-512e860b428c" alt=""><figcaption></figcaption></figure>

From **Installed App Triggers**, you will see Smartrr in the sidebar. Click to reveal the full list of triggers and actions available to be added as nodes to your workflow.&#x20;

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FnKfwgC5ES4hfDfaW4P2E%2Fselect-smartrr.png?alt=media&#x26;token=8671e7d0-610c-44b3-91c7-d30bfaaab04c" alt=""><figcaption></figcaption></figure>

## Example Flows

### Free Gift With Order

Leveraging Smartrr's Shopify Flow integration you can add free gifts to customer's subscription orders. This allows for the ability to surprise and delight customers on a specific order and reward them for being loyal subscribers.

#### How to Setup Flow

1. Create a new Shopify Flow.
2. Select **Triggers** > **Smartrr** > **Subscription transaction successful.**
   1. Note: this triggered is fired when a subscription recurring order is successfully processed in Shopify.

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FXiaKRedDfSHJIG0TXDDi%2Fimage.png?alt=media&#x26;token=8fe099c4-2d45-4035-bd20-aec5a5c34a6c" alt="" width="301"><figcaption></figcaption></figure>

3. Add Condition > choose **orderNumber** > specify the order number.
   1. Note: this will be the order number for the subscription that you want the action to be applied. For example, on all subscriptions 3rd order you want to add a free gift, then enter 3. This condition is looking ONLY at subscription orders for each individual subscription. It is differentiating subscription orders for that subscription specifically and does not count total orders for that customer.

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FbcMvUvRmi9F1oM5cyWfM%2Fimage.png?alt=media&#x26;token=a1e045e3-a815-4198-bdd5-05e675729528" alt=""><figcaption></figcaption></figure>

4. Add Action > choose **Shopify** > **Add order line item.**

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2F0cxqoIEnYC5oiJaEAGDR%2Fimage.png?alt=media&#x26;token=c71c4576-9b8e-4357-82bf-99d18b59488f" alt="" width="297"><figcaption></figcaption></figure>

5. Specify the product that you want to add to the order.
   1. Note: make sure the product you are adding has a $0 base price in Shopify .
6. Turn on workflow.

### Auto-Pause Subscriptions

The Smartrr action to pause subscriptions in Shopify Flow can be used to simulate a pre-order type setup by allowing you to automatically pause subscriptions after they are initially created. This will enable you to capture payments for subscriptions upfront while placing the subscriptions on pause until you are ready to be fulfilling and shipping orders.

#### How to Setup Flow

1. Create a new Shopify Flow.
2. Select **Triggers** > **Smartrr** > **Subscription created.**
3. (Optional) Add Conditions where appropriate.
4. Add Action > choose **Smartrr** > **Pause Subscription.**

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FLAkthLu2IJc548HdvuFN%2Fimage.png?alt=media&#x26;token=21f76914-2cb9-432d-9a85-70a877880111" alt="" width="298"><figcaption></figcaption></figure>

5. Turn on workflow.