How to show each recipient a live points balance in Klaviyo

Pick a method

• Method 1, a profile property: the number is already on the Klaviyo profile. Simple, no account needed for a Stat Counter, but the number is fixed when Klaviyo sends the email.
• Method 2, pushed values: you send each person’s number to DynaMail. The image shows the latest value every time it loads, including after the email has gone out.

Both work with a progress bar (points toward a reward, as below) or a Stat Counter (the number alone). For a Stat Counter, use value= where the examples use current=, and drop target.

Method 1: merge a profile property into the URL

1. 1

   Create the widget

   Save a progress bar in DynaMail (the Loyalty Points template is a good start), or make a Stat Counter with the free stat counter generator.

2. 2

   Add an HTML block and paste this

   Points from loyalty_points

   Copy

   {% if person.loyalty_points %}
   <img src="https://img.dynamail.io/widgets/YOUR-WIDGET-ID/render.png?current={{ person.loyalty_points }}&amp;target=1000" alt="Your points toward the next reward" width="340" height="184" style="display:block;border:0;" />
   {% endif %}

   {{ person.loyalty_points }} is Klaviyo’s dot notation for a profile property; Klaviyo says to use it for names without spaces or special characters. Keep the property name that way, because the lookup form for other names needs quote marks, which do not belong inside an HTML attribute.

   The {% if %} wrapper comes from Klaviyo’s conditional logic reference. It skips the image for profiles without the property, whose empty value would otherwise show the widget’s own live or saved value instead of theirs. A balance of zero may count as empty too, so include a zero-balance profile when you preview.

3. 3

   Preview with a real profile

   Klaviyo’s preview renders profile-based variables when you pick a real profile. Choose one with points and one without, and check both.

Method 2: push each person’s value to DynaMail

1. 1

   Create the widget in a free account

   Pushed values need a saved widget, so sign up (free while in beta) and save a progress bar or Stat Counter. Its detail page has an Automation card with the endpoint.

2. 2

   Send each recipient's value

   Push a value with a recipient, using the same email address Klaviyo will merge into the URL. Zapier, Make and n8n recipes are on the Integrations page; for a one-off load, the Automation card can import a CSV.

   PUT https://api.dynamail.io/widgets/WIDGET_ID/live-value

   Authenticate with an API key created with the Automation preset under API keys in your dashboard, sent in the X-API-Key header; without it the request is rejected. The developer docs cover the full request.

   Request headers

   Copy

   X-API-Key: dm_sk_your_key_here
   Content-Type: application/json

   Request body

   Copy

   {
     "recipient": "person@example.com",
     "value": 450,
     "sourceVersion": 1
   }

3. 3

   Put the recipient tag in the image URL

   Paste this into an HTML block. {{ email|urlencode }} is Klaviyo’s email tag with its documented urlencode filter, so addresses containing + survive the query string.

   Live per-recipient points

   Copy

   <img src="https://img.dynamail.io/widgets/YOUR-WIDGET-ID/render.png?target=1000&amp;recipient={{ email|urlencode }}" alt="Your points toward the next reward" width="340" height="184" style="display:block;border:0;" />

4. 4

   Update values whenever they change

   Push again after a purchase or a redemption, with a sourceVersion higher than the last one you sent for that recipient; a timestamp or an order number works. DynaMail rejects a new value that reuses an older version, so resend the same version only when retrying the exact same update. The next time a recipient’s email loads the image, it shows the new balance; nothing in Klaviyo changes.

Limits and privacy for pushed values

• Recipients are matched without regard to letter case, and anyone without a pushed value sees the widget’s shared value instead.
• 10,000 recipients per widget on the free plan; more on paid plans when they launch. Send up to 500 in one bulk request.
• Values expire 90 days after the last write.
• DynaMail stores a salted hash of each recipient identifier, never the address itself, and sends recipient images with private, no-store caching headers. Email clients can still keep their own copy of an image they have fetched.