Register wallet events

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.

‍

‍

Enable events

To start receiving events in Klaviyo:

1. Go to Settings → Integrations → Klaviyo.
2. Toggle the Events feature on.
3. Save your changes.

From that moment, every customer event fires a Klaviyo Event API call attached to the customer's profile. You can see them in each profile's activity timeline.

‍

‍

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:

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