Register Wallet Events on Klaviyo

JeriCommerce sends all 19 customer events to Klaviyo automatically via the Events API. This means you can trigger flows, build segments, and create reports based on loyalty activity and coupon expiry. For the full list of events and their properties, see the Events reference guide.

For the Balance changed event, event.previous is the points balance before the change.

The Coupon expiring event includes the code and its expiry details for Klaviyo automations.

Turn on events ¶

Event metric names ¶

Each event appears in Klaviyo as a metric with the same name listed in the Events reference guide (e.g., Balance changed, Wallet pass installed, Customer birthday). Use these names when setting up flow triggers or segment conditions in Klaviyo.

For the five JeriCommerce automatic emails, use these metrics: Customer created, Wallet pass requested, Coupon assigned, Reward redeemable, and Reward redeemed. The automatic email guide explains which properties to place in each email and when to turn off the matching JeriCommerce email.

Klaviyo event payload ¶

Each event is sent via the Klaviyo Events API with this structure:

{
  "data": {
    "type": "event",
    "attributes": {
      "time": "2026-03-08T12:00:00Z",
      "properties": { ... },
      "metric": {
        "data": {
          "type": "metric",
          "attributes": { "name": "Balance changed" }
        }
      },
      "profile": {
        "data": {
          "type": "profile",
          "attributes": { "email": "customer@example.com" }
        }
      }
    },
    "unique_id": "event-uuid"
  }
}

The metric.name field matches the event names from the reference guide — use these when setting up Klaviyo flow triggers or segment conditions.

Synced custom profile fields ¶

In addition to events, JeriCommerce syncs these custom fields to each Klaviyo profile automatically:

Use these fields to build Klaviyo segments (e.g., all customers in the "Gold" tier) or personalize email and SMS content with loyalty data.