Klaviyo Sync
Klaviyo Sync

Knowledge Base

This add-on connects MyRewards (WooRewards) to Klaviyo. It pushes each customer’s loyalty point balance — and their date of birth — to their Klaviyo profile as custom properties, so you can use them inside your Klaviyo emails, segments and flows.

Purchase and Installation

First you need to download and install the Add-On. Go to the following page:

WordPress Admin
Admin menu
WooRewards
Menu entry
Add-Ons
Page
Klaviyo Sync
Item

Click the Add to Cart button. It will open a new tab in your browser. Proceed with the purchase. As a result, you will receive an email with a link to download the plugin’s zip file. Once you have the file, do the following:

WordPress Admin
Admin menu
Plugins
Menu entry
Add New
Page
Upload Plugin
Button

Select your zip file and upload it. At the end of the process, click on Activate.

The next thing to do is to activate your license for the Add-On. Check your order confirmation email and copy the license key you can find inside. Then, go to the following page :

WordPress Admin
MyRewards
System
License Management

Find the Installed Extensions group and you should see the addon in the list. Paste your license key here and click on the button to activate it. That’s it, the Add-On is active and you can start using it.

This add-on requires WooRewards Pro 4.2.5 or higher. Without it, the addon stays inactive and only displays a notice in the WordPress admin.

How the addon works

Once the addon is enabled and your Klaviyo private API key is saved, the sync runs automatically in the background. Every point change on your site is reflected on the matching Klaviyo profile within seconds.

Here is what gets sent to Klaviyo for each customer :

  • Point balances : For each active Points and Rewards system on your site, a dedicated custom property is created on Klaviyo profiles, named MyRewards Points (Pool Title). You can show points from each loyalty system independently.
  • Date of birth : The customer’s birthday is also synced as a Klaviyo birthday property, so you can build birthday flows directly inside Klaviyo.
  • Profile matching : Profiles are matched on Klaviyo by the customer’s email address.

What you can do with it in Klaviyo

Once your customers’ point balances and birthdays live in Klaviyo, you can build loyalty-driven campaigns without ever leaving Klaviyo.

Examples

Here are some examples of what you can do once points and birthdays are synced :

  • Live balance in emails : Show the current point balance directly in any newsletter → “You currently have 320 points”
  • Threshold trigger : Send an automated email when a customer crosses a level → “You just hit 500 points!”
  • Birthday flow : Run a yearly birthday email with a personalized reward → Happy birthday + bonus points
  • Audience segmentation : Build segments by point balance to target your top members differently

If you want help to set your system up, please contact our support team

Get your Klaviyo API key

Inside your Klaviyo account, go to Account → Settings → API Keys and create a new Private API Key. Copy that key — you will paste it into the addon settings on the next step.

Setup the addon

Go to the following page :

WordPress Admin
Admin menu
MyRewards
Menu entry
System
Page
Klaviyo
Tab

The Klaviyo tab is split into four groups. Configure them in this order.

API Configuration

  • Enable Sync : Master switch. When ON, every point change automatically updates the matching Klaviyo profile.
  • Private API Key : Paste the Klaviyo private API key you generated above.
  • Test API Key : Click Test Connection to confirm the key is valid. The result appears next to the button.
  • Klaviyo Free Plan : Tick this if your Klaviyo account is on the free plan. Bulk Sync will then run at about half speed to stay under the lower rate limits and avoid errors.

Bulk Sync

The Bulk Sync group lets you push every existing customer to Klaviyo in one go. This is what you run once, right after installing the addon, to backfill the data.

Bulk Sync only needs to be run once, right after the initial setup. After that, the day-to-day sync handles all point changes automatically.
  • Sync All Users : Starts the bulk sync. The addon walks through your users in the background, in small batches, until everything is sent to Klaviyo. You can close the tab — the sync continues on the server.
  • Stop after current batch : Cleanly stops the sync. The current in-flight batch finishes (so no profile is left half-synced) then the process halts.
  • Reset progress : Throws away saved progress and lets you start a fresh sync from scratch. Use this only if a previous sync got stuck.
  • Progress display : Shows the live count of synced profiles, errors and pending retries. Failed profiles (e.g. temporary 429 rate limits from Klaviyo) are automatically retried up to 3 times before being marked as a permanent error.
A health banner at the top of the Bulk Sync group tells you whether scheduled tasks (WP-Cron) are working on your site. If WP-Cron is disabled, keep the tab open while the sync runs, or set up a system cron pointing to wp-cron.php.

Activity Log

The Activity Log shows the most recent sync events: successes, retries, permanent errors, lifecycle events (sync started, finished, cancelled), and any per-user issues.

  • Filter : Choose a level (Errors only, Warnings, Info, All) to focus on what matters.
  • Refresh : Manually reload the latest entries.
  • Download CSV : Export the current log as a CSV file. Use this to share with our support team if something goes wrong — no debug logging needed.
  • Clear log : Removes all entries.

Using Points in Klaviyo Emails

In the Using Points in Klaviyo Emails group, you will find :

  • Property names : The exact list of property names created for your site, one per active loyalty system.
  • Lookup syntax : The Klaviyo template tag to use in your emails, since the property names contain spaces and parentheses.
  • Conditional example : A ready-to-paste snippet that only shows the points section when the customer actually has a balance.
  • Birthday property : A reminder of how the birthday property is named and how to use it in templates.

Quick template snippet

Paste this into a Klaviyo email template to display the customer’s point balance only when they have one :

{% if person|lookup:'MyRewards Points (Standard)' %}
  You have {{ person|lookup:'MyRewards Points (Standard)' }} points!
{% endif %}

Verifying that profiles are synced

To check that everything is working, go into your Klaviyo account, open Profiles, click on one of your customers, and look at the Custom Properties section. You should see one MyRewards Points (…) property per active loyalty system, plus the birthday property when a date of birth is known for that customer.

If you want help to set your system up, please contact our support team

Was this article helpful?
Dislike 0
Views: 5