Sync Custom Fields with Klaviyo

Profile properties, data formats, and sync details for the Klaviyo integration

When Custom Fields is enabled on your Klaviyo integration, JeriCommerce syncs customer attributes as profile custom properties via the Klaviyo Profile Import API. These properties appear in Klaviyo > Profiles > [Profile] > Custom Properties, and can be used in flows, segments, and dynamic content.

‍

For the full list of synchronized properties, what they represent, and when each one syncs, see Custom Fields: Synchronized Customer Properties.

‍

Klaviyo Property Naming

Most property names match the generic ones, but there are key differences in naming and data types specific to Klaviyo:

‍

Klaviyo Property Name	Type
balance	integer (as string)
birthdate	date (yyyy-MM-dd)
jericommerce_download_wallet_pass_url	URL string
tier-name	string
tier-balance	integer (as string)
tier-entered-at	date (yyyy-MM-dd)
tier-expires-at	date (yyyy-MM-dd)

‍

Key Differences vs Shopify

Profile identification: Customers are matched by email in Klaviyo (vs. Shopify's GraphQL customer ID).
Property naming: The download URL maps to jericommerce_download_wallet_pass_url (underscores instead of hyphens).
Date formatting: Dates are sent as yyyy-MM-dd strings. If a date is missing, the value "-" is sent.

‍

How Sync Works on Klaviyo

Real-time: Each property updates via Klaviyo's Profile Import API (POST /api/profile-import/) when the data changes (2-second debounce).
Bulk sync: When Custom Fields is first enabled, a bulk import runs using Klaviyo's Profile Bulk Import Jobs API, processing 500 customers per batch.

‍