Update Shopify Customer Metafield with Yotpo Loyalty Points

When a customer's Yotpo loyalty points balance changes (from earning points on purchases, claiming rewards, redeeming points, or manual adjustments), this trigger activates the workflow and captures loyalty data including {{yotpoloyalty.customer.email}} (the customer's email address) and {{yotpoloyalty.current_balance}} (their new total point balance). The workflow runs for every points change across all customers in your Yotpo loyalty program.

This step searches your Shopify customer database using the email address from {{yotpoloyalty.customer.email}}, limiting results to 1 customer. The search returns the Shopify customer ID as {{shopify.0.id}} which is needed to update the metafield. Using email as the matching key ensures the workflow works even if Yotpo and Shopify use different internal customer IDs, as email is typically the common identifier between systems.

This step creates or updates a metafield on the Shopify customer profile using {{shopify.0.id}} as the customer identifier. The metafield is configured with namespace "custom", key "yotpo_loyalty_points", type "number_integer", and value {{yotpoloyalty.current_balance}}. This creates a metafield accessible as customer.metafields.custom.yotpo_loyalty_points in Shopify Liquid themes and APIs. The metafield updates with each points change, so it always reflects the customer's current balance.

Important note: The first time this workflow runs for a customer, Shopify will automatically create the metafield definition if it doesn't exist. Once created, you can customize the metafield settings in Shopify admin under Settings > Custom Data > Customers.