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:
- Go to Settings → Integrations → Klaviyo.
- Toggle the Events feature on.
- 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.
JeriCommerce events visible on a Klaviyo customer profile
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:
Field nameFormatDescriptionbalanceNumberCurrent loyalty points balancebirthdateyyyy-MM-ddCustomer's date of birthjericommerce_tier_nameStringCurrent tier namejericommerce_tier_balanceNumberPoints counting toward tier statusjericommerce_tier_entered_atyyyy-MM-ddDate the customer entered the current tierjericommerce_tier_expires_atyyyy-MM-ddDate the tier status will be recalculatedjericommerce_download_wallet_pass_urlURLUniversal link for downloading the wallet pass
Use these fields to build Klaviyo segments (e.g., all customers in the "Gold" tier) or personalize email/SMS content with loyalty data.