Tag First-Time Recharge Subscription Orders in Shopify

This step monitors your Recharge account for newly created orders and captures all the order details including customer information and line items. The trigger activates automatically whenever a customer places a new subscription order, gathering the data needed to determine if this is their first subscription purchase. No configuration is required - MESA connects to your Recharge account and listens for new order events in real-time.

The Loop step takes each line item from the subscription order and processes them one by one, since customers can order multiple different subscription products in a single transaction. This ensures that if someone orders both coffee and protein powder subscriptions for the first time, both products get properly evaluated and tagged. The loop automatically iterates through all line items and passes each product's purchase item ID to the next step for individual analysis.

This step queries Recharge's API to find all previous orders from the same customer for the same subscription product using the customer ID and purchase item ID. It retrieves the complete order history to determine if this is truly the customer's first time ordering this specific subscription item. The search results get passed to the filter step, which will count the total number of matching orders to make the first-time determination.

The filter examines the order count returned from the previous step and only allows the workflow to continue if exactly one order is found (meaning this is the first time this customer has ordered this specific subscription product). If the count equals 1, the customer gets tagged as a first-time subscriber for this product. If more than one order exists, the workflow stops and no tag is applied, preventing duplicate tagging on repeat orders.

const Mesa = require('vendor/Mesa.js');
const Filter = require('vendor/Filter.js');

/**
 * A Mesa Script exports a class with a script() method.
 */
module.exports = new class {

  /**
   * Mesa Script
   *
   * @param {object} payload The payload data
   * @param {object} context Additional context about this task
   */
  script = (payload, context) => {

    let {a, b, comparison, additional} = context.trigger.metadata;

    if (Filter.process(a, b, comparison, additional)) {
      // Passed the filter, call the next step and pass the original payload
      Mesa.log.debug(`Conditions passed: ${Filter.stringify(a, b, comparison, additional)}`);
      Mesa.output.next(payload);
    }
    else {
      // Did not pass the filter, stop execution by doing nothing
      // Alternatively add code here if you would like something to happen when the conditions do not pass
      Mesa.log.warn(`Conditions (${Filter.stringify(a, b, comparison, additional)}) did not pass, stopping execution`);
      Mesa.log.debug('Full configuration', context.trigger.metadata);
    }
  }
}

This action adds the “Subscription First Order” tag directly to the corresponding Shopify order using the external order ID from Recharge. The tag appears in your Shopify admin under the order details, allowing you to create customer segments, trigger email campaigns, or apply special discounts for first-time subscribers. You can customize the tag name in the configuration if you prefer different wording like “New Subscriber” or “First Subscription Order”.