Register Wallet Events on Klaviyo

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

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.

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: