Sync Yotpo Points Balance to Omnisend Contacts

The trigger activates automatically whenever Yotpo processes a points change for any customer - whether they earned points from a purchase, referral, or review, or spent points on rewards. You'll need to install the webhook URL that MESA provides into your Yotpo loyalty program settings to establish the connection. This step captures the customer's email address and current points balance, then passes this data to the next step for processing. No other configuration is needed since the trigger responds to all points changes across your entire customer base.

The step automatically queries Omnisend using the customer email address from the Yotpo trigger to locate their contact profile. It searches through up to 100 contacts with the matching email address and retrieves their contact details, including the unique contact ID needed for the update step. The search runs automatically using the email address captured in step 1, so no manual configuration is required. If multiple contacts share the same email (which is rare), the workflow will process the first match found.

The filter checks that the contact search returned exactly one result by comparing the number of contacts found to the value "1". If the condition passes (meaning one contact was found), the workflow proceeds to update that contact's loyalty points. If zero contacts are found, it means the customer doesn't exist in Omnisend yet, and if multiple contacts are found, it indicates a data issue that should be resolved manually. This safety check ensures the workflow only updates valid, unique contact records.

The update step automatically adds or modifies the "yotpo_loyalty_points" custom property in the matched contact's Omnisend profile with their current points balance from Yotpo. The contact ID comes from the search results in step 2, while the points value comes from the original Yotpo trigger. Once updated, you can use this points data in Omnisend to segment customers, personalize email content with their points balance, or trigger campaigns when customers reach certain points thresholds. The custom property will be visible in the contact's profile and available for all campaign targeting.