Klaviyo Events & Properties
Events Sent to Klaviyo (Destination)
Vendo sends behavioral events to Klaviyo using the Events API . Events are batched (up to 1,000 per request) and deduplicated by unique_id.
Standard Event Fields
| Field | Klaviyo Mapping | Description |
|---|---|---|
event_name | metric.name | Event name (e.g., Order Placed) |
email | profile.email | Customer email address |
distinct_id | profile.external_id | Unique customer identifier |
event_time | time | ISO 8601 timestamp |
insert_id | unique_id | Deduplication key |
properties | properties | Custom event properties (JSON) |
Revenue Event Fields
For events with revenue data (e.g., from Stripe or Shopify sources):
| Field | Klaviyo Mapping | Description |
|---|---|---|
value | properties.$value | Revenue amount |
order_id | properties.order_id | Order identifier |
total_amount | properties.total_amount | Total transaction amount |
currency | properties.currency | Transaction currency |
User Profiles Sent to Klaviyo (Destination)
Vendo sends customer profiles using the Profiles API . Profiles are batched (up to 10,000 per request) and deduplicated by external_id.
Profile Field Mapping
| Vendo Field | Klaviyo Attribute | Description |
|---|---|---|
email | email | Contact email |
first_name | first_name | First name |
last_name | last_name | Last name |
phone_number | phone_number | Phone for SMS |
distinct_id | external_id | External identifier |
| Additional fields | properties.* | Custom profile properties |
Data Imported from Klaviyo (Source)
Events Stream
Klaviyo events are imported with their full attribute set, including:
- Event type and metric name
- Associated profile (email, ID)
- Event properties and metadata
- Timestamps and flow/campaign attribution
Profiles Stream
All Klaviyo profiles are imported with:
- Contact information (email, phone, name)
- Custom properties
- Consent and subscription status
- List and segment memberships
Campaigns Stream
Campaign metadata including:
- Campaign name, status, and type (email/SMS)
- Send time and audience info
- Message content references
Lists Stream
List definitions with:
- List name and ID
- Member count
- Creation and update timestamps
Flows Stream
Automation flow data including:
- Flow name, status, and trigger type
- Action sequences and filter definitions
Metrics Stream
Metric definitions for all event types tracked in your Klaviyo account.
Last updated on