Klaviyo data reference

A per-tab list of every column SyncRange can export from Klaviyo, with a short description of what each one contains. Use this page when picking columns in the export builder, or when you need to know exactly what a value represents in BigQuery or Google Sheets.

Each tab below notes whether it uses the export date range or always exports a full current snapshot (date range does not apply).

Nested objects are flattened into columns where possible; remaining objects and arrays are exported as JSON text. For configuration steps see Configuring Klaviyo exports.

Profiles

One row per customer profile. Date range: filtered by profile updated timestamp.

ColumnDescription
Profile IDKlaviyo profile ID.
TypeKlaviyo JSON:API resource type for this object.
EmailProfile email address.
Phone NumberProfile phone number in E.164 format when available.
External IDYour external identifier mapped onto the profile or catalog object.
Anonymous IDAnonymous identifier before identity merge, when present.
First NameProfile first name.
Last NameProfile last name.
OrganizationCompany or organization on the profile.
TitleJob title on the profile when set.
ImageProfile image URL when set.
CreatedWhen the object was created in Klaviyo.
UpdatedWhen the object was last updated in Klaviyo.
Last Event DateTimestamp of the profile's most recent tracked event.
Location Address 1Street address line 1.
Location Address 2Street address line 2.
Location CityCity.
Location RegionRegion, state, or province.
Location CountryCountry.
Location ZipPostal or ZIP code.
Location TimezoneInferred timezone for the profile location.
Location LatitudeLatitude when known.
Location LongitudeLongitude when known.
Location IPLast known IP address when Klaviyo provides it.
PropertiesCustom profile properties as JSON.
SubscriptionsEmail/SMS subscription and consent details as JSON.
Predictive AnalyticsPredictive analytics fields as JSON when available on the account.
RelationshipsRelated object references as JSON (when Klaviyo returns them).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Events

One row per tracked event. Date range: filtered by event datetime. Large accounts can produce high volume; prefer narrower ranges or Since last export for incremental syncs.

ColumnDescription
Event IDKlaviyo event ID.
TypeKlaviyo JSON:API resource type for this object.
TimestampUnix timestamp for the event.
DatetimeEvent datetime used for date-range filtering.
UUIDUnique event UUID from Klaviyo.
Event PropertiesEvent-specific properties as JSON.
Profile IDRelated profile ID when present on the event.
Metric IDRelated metric ID for the event.
RelationshipsRelated object references as JSON (when Klaviyo returns them).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Accounts

One row for the authenticated Klaviyo account. Full export each run: always current account metadata; the date range does not apply.

ColumnDescription
Account IDKlaviyo account ID.
TypeKlaviyo JSON:API resource type for this object.
Test AccountWhether this is a Klaviyo test account.
Public API KeyPublic (site) API key for the account.
LocaleAccount locale.
CurrencyDefault account currency.
TimezoneAccount timezone.
Preferred CurrencyPreferred reporting currency when set.
Contact InformationAccount contact details as JSON.
IndustryIndustry classification for the account when set.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Lists

One row per static list. Full export each run: always current lists; the date range does not apply.

ColumnDescription
List IDKlaviyo list ID.
TypeKlaviyo JSON:API resource type for this object.
NameList name.
CreatedWhen the object was created in Klaviyo.
UpdatedWhen the object was last updated in Klaviyo.
Opt-In ProcessList opt-in process (for example single or double opt-in).
Profile CountNumber of profiles on the list when returned.
RelationshipsRelated object references as JSON (when Klaviyo returns them).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Segments

One row per dynamic segment. Full export each run: always current segments; the date range does not apply.

ColumnDescription
Segment IDKlaviyo segment ID.
TypeKlaviyo JSON:API resource type for this object.
NameSegment name.
CreatedWhen the object was created in Klaviyo.
UpdatedWhen the object was last updated in Klaviyo.
Is ActiveWhether the segment is active.
Is ProcessingWhether Klaviyo is currently recalculating the segment.
Is StarredWhether the segment is starred in Klaviyo.
DefinitionSegment definition / filter rules as JSON.
RelationshipsRelated object references as JSON (when Klaviyo returns them).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Email Campaigns

One row per email campaign (channel filter applied). Full export each run: always current campaigns; the date range does not apply.

ColumnDescription
Campaign IDKlaviyo campaign ID.
TypeKlaviyo JSON:API resource type for this object.
NameCampaign name.
StatusCurrent status as reported by Klaviyo.
ArchivedWhether the campaign or flow is archived.
AudiencesAudience targeting configuration as JSON.
Send OptionsSend options as JSON.
Tracking OptionsTracking options as JSON.
Send StrategySend strategy as JSON.
Created AtCreated timestamp from Klaviyo.
Scheduled AtScheduled send timestamp when set.
Updated AtLast updated timestamp from Klaviyo.
Send TimeActual or planned send time when returned.
RelationshipsRelated object references as JSON (when Klaviyo returns them).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

SMS Campaigns

One row per SMS campaign (channel filter applied). Full export each run: always current campaigns; the date range does not apply.

ColumnDescription
Campaign IDKlaviyo campaign ID.
TypeKlaviyo JSON:API resource type for this object.
NameCampaign name.
StatusCurrent status as reported by Klaviyo.
ArchivedWhether the campaign or flow is archived.
AudiencesAudience targeting configuration as JSON.
Send OptionsSend options as JSON.
Tracking OptionsTracking options as JSON.
Send StrategySend strategy as JSON.
Created AtCreated timestamp from Klaviyo.
Scheduled AtScheduled send timestamp when set.
Updated AtLast updated timestamp from Klaviyo.
Send TimeActual or planned send time when returned.
RelationshipsRelated object references as JSON (when Klaviyo returns them).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Flows

One row per automated flow. Full export each run: always current flows; the date range does not apply.

ColumnDescription
Flow IDKlaviyo flow ID.
TypeKlaviyo JSON:API resource type for this object.
NameFlow name.
StatusCurrent status as reported by Klaviyo.
ArchivedWhether the campaign or flow is archived.
CreatedWhen the object was created in Klaviyo.
UpdatedWhen the object was last updated in Klaviyo.
Trigger TypeHow the flow is triggered (for example metric, list, segment).
RelationshipsRelated object references as JSON (when Klaviyo returns them).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Metrics

One row per metric available in the account. Full export each run: always current metrics; the date range does not apply.

ColumnDescription
Metric IDKlaviyo metric ID.
TypeKlaviyo JSON:API resource type for this object.
NameMetric name.
CreatedWhen the object was created in Klaviyo.
UpdatedWhen the object was last updated in Klaviyo.
IntegrationSource integration metadata as JSON.
RelationshipsRelated object references as JSON (when Klaviyo returns them).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Catalog Items

One row per catalog item. Full export each run: always current catalog items; the date range does not apply.

ColumnDescription
Item IDKlaviyo catalog item ID.
TypeKlaviyo JSON:API resource type for this object.
External IDYour external identifier mapped onto the profile or catalog object.
TitleCatalog item or variant title.
DescriptionCatalog description text.
PricePrice value from the catalog object.
URLProduct or item URL.
Image URLFull-size image URL.
PublishedWhether the catalog object is published.
CreatedWhen the object was created in Klaviyo.
UpdatedWhen the object was last updated in Klaviyo.
Custom MetadataCustom catalog metadata as JSON.
RelationshipsRelated object references as JSON (when Klaviyo returns them).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Catalog Variants

One row per catalog variant. Full export each run: always current variants; the date range does not apply.

ColumnDescription
Variant IDKlaviyo catalog variant ID.
TypeKlaviyo JSON:API resource type for this object.
External IDYour external identifier mapped onto the profile or catalog object.
TitleCatalog item or variant title.
DescriptionCatalog description text.
SKUSKU for the variant.
Inventory PolicyInventory policy for the variant.
Inventory QuantityAvailable inventory quantity.
PricePrice value from the catalog object.
URLProduct or item URL.
Image URLFull-size image URL.
PublishedWhether the catalog object is published.
CreatedWhen the object was created in Klaviyo.
UpdatedWhen the object was last updated in Klaviyo.
Custom MetadataCustom catalog metadata as JSON.
RelationshipsRelated object references as JSON (when Klaviyo returns them).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Catalog Categories

One row per catalog category. Full export each run: always current categories; the date range does not apply.

ColumnDescription
Category IDKlaviyo catalog category ID.
TypeKlaviyo JSON:API resource type for this object.
External IDYour external identifier mapped onto the profile or catalog object.
NameCategory name.
UpdatedWhen the object was last updated in Klaviyo.
RelationshipsRelated object references as JSON (when Klaviyo returns them).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Coupons

One row per coupon definition. Full export each run: always current coupons; the date range does not apply.

ColumnDescription
Coupon IDKlaviyo coupon definition ID.
TypeKlaviyo JSON:API resource type for this object.
External IDYour external identifier mapped onto the profile or catalog object.
DescriptionCoupon definition description.
RelationshipsRelated object references as JSON (when Klaviyo returns them).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Coupon Codes

One row per individual coupon code. Full export each run: always current codes; the date range does not apply.

ColumnDescription
Coupon Code IDKlaviyo coupon code ID.
TypeKlaviyo JSON:API resource type for this object.
Unique CodeThe unique coupon code string.
Expires AtExpiration timestamp for the code when set.
StatusCurrent status as reported by Klaviyo.
RelationshipsRelated object references as JSON (when Klaviyo returns them).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Forms

One row per signup or embeddable form. Full export each run: always current forms; the date range does not apply.

ColumnDescription
Form IDKlaviyo form ID.
TypeKlaviyo JSON:API resource type for this object.
NameForm name.
StatusCurrent status as reported by Klaviyo.
A/B TestA/B test configuration as JSON when enabled.
Created AtCreated timestamp from Klaviyo.
Updated AtLast updated timestamp from Klaviyo.
RelationshipsRelated object references as JSON (when Klaviyo returns them).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Images

One row per uploaded image. Full export each run: always current images; the date range does not apply.

ColumnDescription
Image IDKlaviyo image ID.
TypeKlaviyo JSON:API resource type for this object.
NameImage name in the library.
Image URLHosted image URL.
FormatImage file format (for example png, jpeg).
SizeImage size metadata from Klaviyo.
HiddenWhether the image is hidden in the library.
Updated AtLast updated timestamp from Klaviyo.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Tags

One row per account tag. Full export each run: always current tags; the date range does not apply.

ColumnDescription
Tag IDKlaviyo tag ID.
TypeKlaviyo JSON:API resource type for this object.
NameTag name.
RelationshipsRelated object references as JSON (when Klaviyo returns them).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Templates

One row per email or message template. Full export each run: always current templates; the date range does not apply. HTML and text bodies can be large; select those columns only when needed.

ColumnDescription
Template IDKlaviyo template ID.
TypeKlaviyo JSON:API resource type for this object.
NameTemplate name.
Editor TypeTemplate editor type (for example SYSTEM_DRAGGABLE, CODE).
HTMLTemplate HTML body.
TextTemplate plain-text body.
CreatedWhen the object was created in Klaviyo.
UpdatedWhen the object was last updated in Klaviyo.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Reviews

One row per product review when Klaviyo Reviews is enabled. Full export each run: always current reviews; the date range does not apply. May be empty if Reviews is not enabled on the account.

ColumnDescription
Review IDKlaviyo review ID.
TypeKlaviyo JSON:API resource type for this object.
EmailReviewer email address when available.
StatusCurrent status as reported by Klaviyo.
VerifiedWhether the review is verified.
CreatedWhen the object was created in Klaviyo.
UpdatedWhen the object was last updated in Klaviyo.
RatingStar rating value.
TitleReview title.
ContentReview body text.
ProductReviewed product details as JSON.
AuthorReview author details as JSON.
RelationshipsRelated object references as JSON (when Klaviyo returns them).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Related

Something missing on this page? Email [email protected]

Start syncing your ecommerce data in minutes Start free today. No credit card required.